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CHAPTER 1 
Introduction 


1.1 INTRODUCTION TO MCS BASIC-52 

Welcome to MCS® BASIC-52. This program functions as a BASIC interpreter occupying 8K of ROM in 
INTEL’S 8052AH microcontroller. MCS BASIC-52 provides most of the features of “standard” BASICS, 
plus many additional features that apply to control environments and to the architecture of the 8052AH. 

The design goal of MCS BASIC-52 was to develop a software program that would make it easy for a 
hardware/software designer to interact with the 8052 device; but, at the same time not limit the designer 
to the slow and sometimes awkward constructs of BASIC. This program is not a “toy” like many of the 
so called TINY BASICS. It is a powerful software tool that can significantly reduce the design time of 
many projects. MCS BASIC-52 is ideal for so called imbedded systems, where terminals are not attached 
to system, but the system controls and manipulates equipment and data. 

MCS BASIC-52 offers many unique hardware and software features, including the ability to store and 
execute the user program out of an EPROM, the ability to process interrupts within the constructs of a 
BASIC program, plus an accurate real time clock. In addition, the arithmetic routines and I/O routines 
contained in MCS BASIC-52 can be accessed with assembly language CALL routines. This feature can 
be used to eliminate the need for the user to write these sometimes difficult and tedious programs. 

All of the above are covered in this document. This is NOT a “How to Write Basic Programs” manual. 
Many excellent texts on this subject have been produced. Your local computer store can recommend many 
such texts. 

The descriptions of many of the statements in this manual involve rather detailed discussions that relate 
to interfacing MCS BASIC-52 to assembly language programs. If the user is not interested in using assembly 
language with MCS BASIC-52 these discussions may be ignored. If you are only interested in programming 
the MCS BASIC-52 device in BASIC, you can treat all statements the same way they would be in any 
standard BASIC interpreter. 

In reading this manual, you will find that some information may be repeated two or three times. This is 
not an accident. Years of experience have proven that one of the most frustrating experiences one encounters 
with manuals is trying to find a particular piece of information that the reader knows is in the manual, but 
can’t remember where. 
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1.2 GETTING STARTED 

If you are like most engineers, technicians, hobbyists and humans, and don’t like to read manuals, this 
section is for you. The purpose of this section is to get you off on the tight foot. If you are in the High 
Anxiety Mode and just want to see if the dam chip works, wire the device in the minimum hardware 
configuration as suggested in the Hardware Configuration chapter of this manual, apply power, and watch 
what happens. NOTHING! That’s because after power is applied to the MCS BASIC-52 device, the 
program initializes the 8052AH hardware and goes into an AUTO-BAUD search routine. You must touch 
the space bar on the serial input device in order to get MCS BASIC-52 to SIGN ON. The message that 
will appear is *MCS-51 BASIC Vx.x*. If a space character is not the first character sent to the MCS 
BASIC-51 device after reset, you can spend a lot of time trying to figure out what went wrong. So do 
yourself a favor, read this section and touch the space bar before you call your local Intel Field Applications 
Engineer. We received a number of questions asking how the AUTO-BAUD search routine worked. As 
a result this routine is listed in Chapter 11 of this manual. 


1.3 WHAT HAPPENS AFTER RESET? 

After RESET, MCS BASIC-52: 

1) Clears the INTERNAL 8052AH memory 

2) Initializes the internal registers and pointers 

3) Tests, clears, and sizes the EXTERNAL memory 

BASIC then assigns the top of EXTERNAL RANDOM ACCESS MEMORY to the SYSTEM CONTROL 
VALUE — MTOP and uses this number as the random number seed. BASIC assigns the default crystal 
value, 11.0592 Mhz, to the SYSTEM CONTROL VALUE — XTAL and uses this default value to calculate 
all time dependent functions, such as the EPROM programming timer and the interrupt driven REAL TIME 
CLOCK. Finally, BASIC checks external memory location 8000H to see if the baud rate information is 
stored. If the baud rate is stored, MCS BASIC-52 initializes the baud rate generator (the 8052AH’s SPECIAL 
FUNCTION REGISTER — T2CON) with this information and signs on. If it isn’t stored, BASIC inter¬ 
rogates the serial port input and waits for a space character to be typed. This sounds like a lot, but on the 
8052AH, it doesn’t take much time. 


2 




MCS® BASIC-52 


Intel 


1.3 WHAT HAPPENS AFTER RESET? 

MCS BASIC-52 initializes the 8052AH’s Special Function Registers, TMOD, TCON, and T2CON with 
the following values: 

TCON - 244 (0F4H) 

TMOD - 16 (lOH) 

T2CON - 52 (34H) 

After Reset, the console device should display the following: 

*MCS-51(tm) BASIC Vx.x* 

READY 

To see if everything is OK after Reset, type the following: 

>PRINT XTAL, TMOD, TCON, T2CON 
(BASIC should respond) 

11059200 16 244 52 

If it does, everything is working properly. If it does not make sure that the external memory, the serial 
port, and the oscillator are connected and working. Hardware debug begins here. 

In the Appendix of this manual is a QUICK REFERENCE GUIDE. It provides a short description of all 
of the COMMANDS and STATEMENTS implemented in MCS BASIC-52. You might want to use this 
section to gain a quick understanding of the MCS BASIC-52 software package. Those of you who are 
familiar with the BASIC language will notice that most of the STATEMENTS and COMMANDS used in 
MCS BASIC-52 are “standard,” so getting started should not be a problem. 
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1.4 DEFINITION OF TERMS: 

COMMANDS: 

MCS BASIC-52 operates in two modes,,the COMMAND or direct mode and the interpreter or RUN mode. 
MCS BASIC-52 Commands can only be entered when the processor is in the COMMAND or direct mode. 
MCS BASIC-52 takes immediate action after a command has been entered. This document will use the 
terms RUN MODE and COMMAND MODE to refer to the two different modes of operation. 

STATEMENTS: 

A BASIC program is comprised of statements. Every statement begins with a line number, followed by 
the statement body, and terminated with a Carriage Return (cr), or a colon (:) in the case of multiple 
statements per line. Some statements can be executed in the COMMAND MODE, others cannot. The 
DESCRIPTION OF STATEMENTS section of this manual describes whether a statement can be executed 
in the COMMAND mode or only in the RUN mode. 

There are three general types of statements in MCS BASIC-52: ASSIGNMENTS, INPUT/OUTPUT, and 
CONTROL. The DESCRIPTION OF STATEMENT section of this manual explains what type is associated 
with each statement. 

• EVERY line in a program must have a statement line number ranging between 0 and 65535 inclusive. 

• Statement numbei^ are used by BASIC to order the program statements sequentially. 

• In any program, a statement number can be used only once. 

• Statements need not be entered in numerical order, because BASIC will automatically order them in 
ascending order. 

• A statement may contain no more than 72 characters in Version 1.0 and no more than 79 in Version 

1 . 1 . 

• Blanks (spaces) are ignored by BASIC and BASIC automatically inserts blanks during LIST. 

• More than one statement can beput on aline, if separated by a colon (:), but only one statement number 

is Mlowed per line. V - 

FORMAT STATEMENTS: 

Format Statements may only be used within the PRINT STATEMENT. The format statements include 
TAB([expr]), SPC([expr]), USING(special symbols), and CR (carriage return with no line feed). Details 
of the format statements are provided in the description of the PRINT STATEMENT section of this manual. 
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1.4 DEFINITION OF TERMS 

DATA FORMAT: 

The range of numbers that can be represented in MCS BASIC-52 is: 

± IE - 127 to ± .99999999E-h 127. 

There are eight digits of significance in MCS BASIC-52. Numbers are internally rounded to fit this precision. 
Numbers may be entered and displayed in four formats: integer, decimal, hexadecimal, and exponential. 
EXAMPLE: 129, 34.98, OA6EH, 1.23456E + 3 

INTEGERS: 

In MCS BASIC-52, integers are numbers that ranges from 0 to 65535 or OFFFFH. All integers can be 
entered in either decimal or hexadecimal format and all hexadecimal numbers must begin with a valid digit 
(e.g. the number AOOOH must be entered OAOOOH). When an operator, such as .AND. requires an integer, 
MCS BASIC-52 will truncate the fraction portion of number so it will fit the integer format. All line 
numbers used by MCS BASIC-52 are integers. This document will refer to integers and line numbers, 
respectively in the following manner: 

[integer] — [In num] 

NOTE — Throughout this document the brackets [] are used only to indicate an integer, constant, etc. 
They are NOT entered when typing the actual number or variable. 

CONSTANTS: 

A constant is a real number that ranges from ± 1 E - 127 to ± .99999999E+ 127. A constant, of course, 
can be an integer. This document will refer to constants in the following manner: 

[const] 

OPERATORS: 

An operator performs a pre-defined operation on variables and/or constants. Operators require either one 
or two operands. Typical two operand or dyadic operators include ADD ( + ), SUBTRACT (-), MUL¬ 
TIPLY (*), and DIVIDE (/). Operators that require only one operand are often referred to as UNARY 
OPERATORS. Some typical UNARY OPERATORS are SIN, COS, and ABS. 
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1.4 DEFINITION OF TERMS 

VARIABLES: 

In Version 1.0 of MCS BASIC-52 a variable could be defined as either a letter, (i.e. A, X, I), a letter 
followed by a number, (i.e. Ql, T7, L3), a letter followed by a ONE DIMENSIONED expression, (i.e. 
J(4), G(A + 6), I(10*SIN(X))), or a letter followed by a number followed by a ONE DIMENSIONED 
expression (i.e, Al(8), P7(DBY(9)), W8(A + B). In Version 1.1 variables can be defined in the same 
manner as in Version 1.0, however variables may also contain up to 8 letters or numbers including the 
underline character. This permits the user to use a more descriptive name for a given variable. Examples 
of valid variables in Version 1.1 of MCS BASIC-52 are as follows: 

FRED VOLTAGEl LIl ARRAY(ELE_1) 

When using the expanded variable names available in Version 1.1 of MCS BASIC-52 it is important to 
note that 1) It takes longer for MCS BASIC-52 to process these expanded variable names and 2) The user 
may not use any keyword as part of a variable name (i.e. the variables TABLE and DIET could not be 
used because TAB and IE are reserved words). BAD SYNTAX ERRORS will be generated if the user 
attempts to define a variable that contains a reserved word. 

Variables that include a ONE DIMENSIONED expression [expr] are often referred to as DIMENSIONED 
or ARRAYED variables. Variables that only involve a letter or a letter and a number are called SCALAR 
variables. The details concerning DIMENSIONED variables are covered in the description of the STATE¬ 
MENT ROUTINE DIM. This document will refer to VARIABLES as: 

[var]. 

MCS BASIC-52 allocates variables in a “static” manner. That means each time a variable is used, BASIC 
allocates a portion of memory (8 bytes) specifically for that variable. This memory cannot be de-allocated 
on a variable by variable basis. That means if you execute a statement like Q = 3, later on you cannot tell 
BASIC that the variable Q no longer exists so, please “free up” the 8 bytes of memory that belong to Q. 
Sorry, it doesn’t work this way. The only way the user can clear the memory that is allocated to variables 
is to execute a CLEAR STATEMENT. This Statement “frees” all memory allocated to variables. 

IMPORTANT NOTE: 

Relative to a dimensioned variable, it takes MCS BASIC-52 a lot less time to find a scalar variable. That’s 
because there is no expression to evaluate in a scalar variable. So, if you want to make a program run as 
fast as possible, use dimensioned variables only when you have to. Use scalars for intermediate variables, 
then assign the final result to a dimensioned variable. 

EXPRESSIONS: 

An expression is a logical mathematical formula that involves OPERATORS (both unary and dyadic), 
CONSTANTS, and VARIABLES. Expressions can be simple or quite complex, i.e. 12*EXP(A)/100, 
H(l)4-55, or (SIN(A)*SIN(A) + COS(A)*COS(A))/2. A “stand alone” variable [var] or constant [const] 
is also considered an EXPRESSION. This document will refer to EXPRESSIONS as: 

[expr]. 
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1.4 DEFINITION OF TERMS 

RELATIONAL EXPRESSIONS: 

Relational expressions involve the operators EQUAL ( = ), NOT EQUAL (<>), GREATER THAN (>), 
LESS THAN (<), GREATER THAN OR EQUAL TO (> = ) and LESS THAN OR EQUAL TO (< = ). 
They are used in control statements to “test” a condition (i.e. IF A < 100 THEN . . .)• Relational 
expressions ALWAYS REQUIRE TWO OPERANDS. This document will refer to RELATIONAL 
EXPRESSIONS as; 

[rel expr]. 

SPECIAL FUNCTION OPERATORS: 

Virtually all of the special function registers on the 8052AH can be accessed by using the special function 
operators. The exceptions are PORTS 0, 2 and 3 and non-I/O associated registers such as ACC, B, and 
PSW. Other SPECIAL FUNCTION OPERATORS are XTAL and TIME. Details of the SPECIAL FUNC¬ 
TION OPERATORS are covered in the section SPECIAL FUNCTION OPERATORS. 

SYSTEM CONTROL VALUES: 

The system control values include the following: LEN (which returns the length of the program), FREE 
(which designates how many bytes of RAM are not used that are allocated to BASIC), and MTOP (which 
is the last memory location that is assigned to BASIC). Details of the system control values are covered 
in the section SYSTEM CONTROL VALUES. 
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STACK 

MCS BASIG-52 reserves the first 512 bytes of EXTERNAL DATA MEMORY to implement two “soft¬ 
ware” stacks. These are the control stack and the arithmetic stack or ARGUMENT STACK. Understanding 
how the stacks work in MCS BASIG-52 is NOT NECESSARY if the user wishes only to program in 
BASIC. However, understanding the stack structure is necessary if the user wishes to link MCS BASIC-52 
to ASSEMBLY language routines, The details of how to link to assembly language are covered in the 
ASSEMBLY LANGUAGE LINKAGE section of this manual. 

CONTROL STACK — The control stack occupies locations 96 (60H) through 254 (OFEH) in external 
ram memory. This memory is used to store all information associated with loop control (i.e. —WHILE, 

DO — UNTIL, and FOR — NEXT) and basic subroutines (GOSUB). The stack is initialized to 254 
(OFEH) and “grows down.” 

ARGUMENT STACK — The ARGUMENT STACK occupies locations 301 (12DH) through 510 (IFEH) 
in external ram memory. This stack stores all constants that MCS BASIC-52 is currently using. Operations 
such as ADD, SUBTRACT, MULTIPLY, and DIVIDE always operate on the first two numbers on the 
ARGUMENT STACK and return the result to the ARGUMENT STACK. The argument stack is initialized 
to 510 (IFEH) and “grows down” as more values are placed on the ARGUMENT STACK. Each floating 
point number placed on the ARGUMENT STACK requires 6 BYTES of storage. 

INTERNAL STACK — The stack pointer on the 8052AH (SPECIAL FUNCTION REGISTER, SP) is 
initialized to 77 (4DH), The 8052AH’s stack pointer “grows up” as values are placed on the stack. In 
MCS BASIC-52 the user has the option of placing the 8052AH’s STACK POINTER anywhere (above 
location 77) in internal memory. The details of how to do this are covered in the ASSEMBLY LANGUAGE 
LINKAGE section of this manual. 

LINE EDITOR: 

MCS BASIC-52 contains a minimum level line editor. Once a line is entered the user may not change the 
line without re-typing the line. However, it is possible to delete characters while a line is in the process 
of being entered.' This is done by entering a RUBOUT or DELETE character (7FH). The RUBOUT 
character will cause the last character entered to be erased from the text input buffer. Additionally, a 
control-D will cause the entire line to be erased. In Version 1.1 of MCS BASIG-52, Control-Q (X-ON) 
and Control S (X-OFF) recognition have been added to the serial port. The user is cautioned not to 
accidently type a Control-S when entering information because the MCS BASIC-52 will no longer respond 
to the console device. Control-Q is used to bring the console device back to life after GontroLS is typed. 

NOTE — In this document a carriage return is indicated by the symbol (cr). The carriage return is the 
RETURN key on most keyboards. 
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1.5 WHAT’S THE DIFFERENCE BETWEEN V1.0 AND V1.1 

Thanks to feedback from many of the users of MCS BASIC-52, a number of changes and additions have 
been made to Version 1.1. All of these changes and additions were made to enhance the usefulness of the 
product and yet retain 100% compatibility, well almost 100% compatibility with the original version. To 
make things simple, all of the changes will be mentioned here and a reference will be provided as to where 
the reader of this manual may obtain more information about the change or addition. 

The only change that has been made to VI. 1 that is not compatible with Vl.O is with the IF_THEN_ 
ELSE STATEMENT when used with multiple statements per line. In Vl.O, the following two examples 
would function in the same manner. 

EXAMPLE 1: 


10 

IF A=B THEN C=A 

A=A/2 

GOTO 100 

20 

PRINT A 




EXAMPLE 2: 


10 IF A=B THEN C=A 
12 A®A/2 
14 GOTO 100 
20 FRINT A 


They function in the same manner because Vl.O treats the delimiter (:) exactly the same as a carriage 
return (cr) in every case. However, VI. 1 executes the remainder of the line if and only if the test A = B 
proves to be true. This means in EXAMPLE 1 IF A did equal B, VI.1 would then set C = A, then set 
A = A/2, then execute line 100. IF A did not equal B, VI.1 would then PRINT A and ignore the statements 
C = A : A = A/2 : GOTO 100. VI. 1 will execute EXAMPLE 2 exactly the same way as Vl.O. This same 
logical interpretation holds true for the ELSE statement as well. This example dictates a simple rule for 
maintainin g TF THEN EL SE compatability between the two versions. IF THE DELIMITER (:) IS NOT 
USED IN AN IF_THEN_ELSE STATEMENT, Vl.O AND VI. 1 WILL TREAT THE STATEMENTS 
IN THE SAME MANNER!! 

This change was made because most users of MCS BASIC-52 felt that the VI. 1 interpretation of this 
statement was more useful because fewer GOTO statements need be employed in a typical program. 

Additionally, VI. 1 accepts inputs in either lower or upper case, whereas Vl.O converted lower case to 
upper case. VI. 1 will however, convert keywords from lower case to upper case during the LISTing of a 
program. Finally, MCS BASIC-52 VI. 1 runs between 2% and 10% faster than Vl.O. Typically, this should 
not cause any problems. 

As far as the user is concerned, these are the only changes that may affect the operation of a typical 
program. Now, on to the additions. 
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1.5 WHAT’S THE DIFFERENCE BETWEEN V1.0 AND V1.1 

ADDITIONS TO MCS BASIC-52 VI .1: 

• X-ON (control Q) and X-OFF (control S) have been added. These permit the user to “stop” (control 
S) and start (control Q) the display of characters during a LIST or PRINT. This feature also permits 
synchronization with external I/O (input/output) devices. The X-OFF (control S) functions on a line by 
line basis, not on a character by character basis. 

• Five new statements have been added. These include IDLE, LD(a), ST@, PGM, and RROM. Details 
of these statements are listed under the DESCRIPTION OF STATEMENTS section of this manual. 

• Six new RESET options have been provided. They permit the user to assign the top of memory (MTOP) 
during reset, and allow the user to write specific RESET programs in assembly language. Additionally, 
they provide an option where the memory WILL NOT be cleared during RESET. More information on 
the specific RESET OPTIONS is detailed in the DESCRIPTIONS OF EPROM FILE COMMANDS 
under PROGl, PROG2, PROGS, PROG4, PROG5, and PROG6 COMMANDS and in Chapter 11 of 
this manual. 

• The Timing of the EPROM programming algorithm has been significantly relaxed between the various 
strobes required for the EPROM programming function. This relaxed timing permits the user to program 
devices such as the 875IH and the 8748/9 using the EPROM programming capabilities of the MCS 
BASIC-52 device. Details of the timing changes are in Chapter 10 of this manual. 

• During EPROM programming, the INTO/DMA REQUEST pin of the MCS BASIC-52 device is treated 
as a ready input pin. This allows for a simple direct connection to EEPROM devices such as the 2817A. 
For normal EPROM programming, INTO must be kept high or the programming hangs up. Details 
concerning the use of EEPROMS with the MCS BASIC-52 device are provided in Chapter 10 of this 
manual. 

• A RUN TRAP option has been provided. This option traps the MCS BASlC-52 interpreter in the program 
RUN mode and will not permit the user to exit this mode. Details of this option are covered in Chapter 
8.4 of this manual. 

• A user STATEMENT/COMMAND expansion option has been provided. This permits the user to easily 
add new or custom STATEMENTS and COMMANDS to MCS BASIC-52. Details of this option are 
covered in Chapter 12 of this manual. 
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1.5 WHATS THE DIFFERENCE BETWEEN V1.0 AND V1.1 

ADDITIONS TO MCS BASIC-52 VI.1: 

• A number of new assembly language user OP BYTES have been added. These permit the user to make 
better use of the STATEMENT/COMMAND expansion option previously described. Details of these 
new OP BYTES are presented in Chapter 9.6 of this manual. 

• The length of the input buffer has been increased from 72 characters to 79 characters and the ERROR: 
LINE TOO LONG has been eliminated. Instead, when the cursor reaches the 79th position a bell 
character will be echoed everytime the user attempts to enter another character. 

• A new variation on the PRINT (including PHO. and PHI.) and LIST statements have been added. This 
new option is evoked with an @ character (EXAMPLE: PRINT(a) or LIST®) and permits the user to 
write specific output drivers for these statements and commands. When the @ PRINT or LIST is evoked, 
MCS BASIC-52 CALLS external code memory location 403CH. The user must put the specific output 
driver in this location. More details of this option is in Description of Statements section of this manual. 

• The control stack has been made more “forgiving.” This means that the user can execute a GOSUB 
to a subroutine that contains a FOR-NEXT loop and return from the subroutine without completing the 
FOR-NEXT loop. Version 1.0 would yield a C-STACK ERROR under these circumstances, VI. 1 yields 
no error. 

• The question mark character ? is interpreted as a PRINT statement (EXAMPLE: (PRINT 10 + 20 is the 
same as ? 10 + 20). The symbols P. remains a shorthand notation for PRINT just as in VI.0. 

• The FOR-NEXT statement can be executed in the direct mode. This lets the user write short routines 
in the DIRECT MODE to, for example, display a region of memory (EXAMPLE: FOR I = 200H to 
210H: PHO. XBY(I): NEXT I) 

• Variables can be up to 8 characters in length, however, only the first character, the last character, and 
the total number of characters are of signifance. This lets the user better describe variables that are used 
in a program. Chapter 1.4 details the limitations on the expanded variables in Version 1.1. 
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1.5 WHAT’S THE DIFFERENCE BETWEEN VI.0 AND VI.1 

ADDITIONS TO MCS BASIC-52 V1.1: 

• The CALL statement vectors to locations 4100H through 41FFH if the CALL integer is between 0 and 
7FH inclusive. This means that CALL 0 will vector to location 4100H, CALL 1 to location 4102H, 
CALL 2 to location 4104H, etc. This permits the user to easily generate assembly language CALL tables 
by using simple integers with the CALL statement. Anyway, CALL 0 through CALL IFFFH was not 
too useful because these numbers vectored into the MCS BASIC-52 ROM. 

• The error message anomaly for an invalid line number on a GOTO or GOSUB STATEMENT has been 
eliminated on V 1.1 of MCS BASIC-52. The correct line number is now processed and displayed by the 
error processor. 

• The FOR-TO-{STEP}-NEXT statement can be executed in the COMMAND MODE in version 1.1 of 
MCS BASIC-52. Additionally, the NEXT statement does not require a variable in version 1.1. Details 
of these features are covered in the Description of Statements section of this manual. 

• The REM statement can be executed in the COMMAND MODE. If the user is employing some type 
of UPLOAD/DOWNLOAD routine with a computer, this lets the user insert REM statements, without 
line numbers in the text and not download them to the MCS BASIC-52 device. This helps to conserve 
memory. 

• Version 1.1 is also a little less “crashable” than version 1.0. This is due to a more extensive “type 
checking” on control transfer routines (i.e. GOTO, GOSUB). 
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CHAPTER 2 

Description of Commands 


2.1 DESCRIPTION OF COMMANDS 

COMMAND: RUN(cr) 

ACTION TAKEN: 

After RUN(cr) is typed all variables are set equal to zero, all BASIC evoked interrupts are cleared and 
program execution begins with the first line number of the selected program. The RUN command and the 
GOTO statement are the only way the user can place the MCS BASIC-52 interpreter into the RUN mode 
from the COMMAND mode. Program execution may be terminated at any time by typing a control-C on 
the console device. 

VARIATIONS: 

Unlike some Basic interpreters that allow a line number to follow the RUN command (i.e., RUN 100), 
MCS BASIC-52 does not permit such a variation on the RUN command. Execution always begins with the 
first line number. To obtain the same functionality as the RUN[ln num] command, use the GOTO[ln num] 
statement in the direct mode. SEE STATEMENT GOTO. 

EXAMPLE: 


>10 FOR I«1 TO 3. 
>20 PRINT I 
>30 NEXT I 
>RUN 

1 

2 

3 

READY 

> 
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2.2 DESCRIPTION OF COMMANDS: 

COMMAND: CONT(cr) 

ACTION TAKEN: 

If a program is stopped by typing a control-C on the console device or by execution of a STOP statement, 
you can resume execution of the program by typing CONT(cr). Between the stopping and the re-starting 
of the program you may display the values of variables or change the values of variables. However, you 
may NOT CONTinue if the program is modified during the STOP or after an error. 

VARIATIONS: 

None. 

EXAMPLE: 


>10 FOR I-l TO 10000 
>20 PRINT I 
>30 NEXT I 
>RUN 

1 

2 

3 

4 

5 - (TYPE CONTROL-C ON CONSOLE) 

STOP - IN LINE 20 

READY 
>PRINT I 

6 

> 1*10 

>CONT 

10 

11 

12 
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2.3 DESCRIPTION OF COMMANDS; 

COMMAND: LIST(cr) 

ACTION TAKEN: 

The LIST(cr) command prints the program to the console device. Note that the list command “formats” 
the program in an easy to read manner. Spaces are inserted after the line number and before and after 
statements. This feature is designed to aid in the debugging of MCS BASIC-52 programs. The “listing” 
of a program may be terminated at anytime by typing a control-C on the console device. 

VARIATIONS: 

Two variations of the LIST COMMAND are possible with MCS BASIC-52. They are: 

LIST [In num] (cr) and 
LIST [In num] — [In num] (cr) 

The first variation causes the program to be printed from the designated line number (integer) to the end 
of the program. The second variation causes the program to be printed from the first line number (integer) 
to the second line number (integer). NOTE — the two line numbers MUST BE SEPARATED BY A 
DASH —. 


EXAMPLE: 


READY 

:>LIST 

10 PRINT "LOOP PROGRAM" 
20 FOR 1=1 TO 3 
30 PRINT I 
40 NEXT I 
50 END 

READY 
:>LIST 30 
30 PRINT I 
40 NEXT I 
50 END 

READY 

:>LIST 20-40 
20 FOR 1=1 TO 3 
30 PRINT I 
40 NEXT I 
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2.4 DESCRIPTION OF COMMANDS 

COMMAND: LIST#(cr) 

ACTION TAKEN: 

The LIST#(cr) command prints the program to the LIST device. The BAUD rate to this device must be 
initialized by the STATfiMENT — BAUDfexpr]. All comments that apply to the LIST command apply 
to the LIST# command. The LIST#(cr) command is included to permit the user to make “hard copies” 
of a program. The output to the list device is on PI.7 of the MCS BASIC-52 device. . 
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2.5 DESCRIPTION OF COMMANDS 

COMMAND: LIST@(cr) (VERSION 1.1 ONLY) 

ACTION TAKEN: 

The LIST(a) command does the same thing as the LIST command except that the output is directed to a 
user defined output driver. This command assumes that the user has placed an assembly language output 
routine in external code memory location 403CH. To enable the @ driver routine the user must SET BIT 
27H (39D) in the internal memory of the MCS BASIC-52 device. BIT 27H (39D) is BIT 7 of internal 
memory location 24H (36D). This BIT can be set by the BASIC statement DBY(24H) = DBY(24H). 
OR.80H or by a user supplied assembly language routine. If the user evokes the @ driver routine and this 
bit is not set, the output will be directed to the console driver. The only reason this BIT must be set to 
enable the @ driver is that it adds a certain degree of protection from accidently typing LIST® when no 
assembly language routine exist. The philosophy here is that if the user sets the bit, the user provides the 
driver or else!!! 

When MCS BASIC-52 calls the user output driver routine at location 403CH, the byte to output is in the 
accumulator and R5 of register bank 0 (RBO). The user may modify the accumulator (A) and the data 
pointer (DPTR) in the assembly language output routine, but cannot modify any of the registers in RBO. 
This is intended to make it real easy for the user to implement a parallel or serial output driver without 
having to do a PUSH or a POP. 
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2.6 DESCRIPTION OF COMMANDS 

COMMAND: NEW(cr) 

ACTION TAKEN: 

When NEW(cr) is entered, MCS BASIC-52 deletes the program that is currently stored in RAM memory. 
In addition, all variables are set equal to ZERO, all strings and all BASIC evoked interrupts are cleared. 
The REAL TIME CLOCK, string allocation, and the internal stack pointer value (location 3EII) are NOT 
effected. In general, NEW (cr) is used simply to erase a program and all variables. 
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2.7 DESCRIPTION OF COMMANDS 

COMMAND: NULL [integer](cr) 

ACTION TAKEN: 

The NULL[integer] (cr) command determines how many NULL characters (OOH) MCS BASIC-52 will 
output after a carriage return. After initialization NULL = 0. The NULL command was more important 
back in the days when a “pure” mechanical printer was the most common I/O device. Most modem 
printers contain some kind of RAM buffer that virtually eliminates the need to output NULL characters 
after a carriage return. NOTE — the NULL count used by MCS BASIC-52 is stored in internal RAM 
location 21 (15H). The NULL value can be changed dynamically in a program by using a DBY(21) = [expr] 
statement. The [expr] can be any value between 0 and 255 (OFFH) inclusive. 

VARIATIONS: 

None. 
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CHAPTER 3 

Description of EPROM Fiie Commands 


DESCRIPTION OF EPROM FILE COMMANDS 

One of the unique and powerful features of MCS BASIC-52 is that it has the ability to execute and SAVE 
programs in an EPROM. MCS BASIC-52 actually generates all of the timing signals needed to program 
most EPROM devices. Saving programs in EPROMS is a much more attractive and RELIABLE alternative 
relative to cassette tape, especially in control and/or noisy environments. 

The hardware needed to permit MCS BASIC-52 to program an EPROM device is minimal, typically only 
one NAND gate, three or four transistors, and a few resistors are all that is required. Details of the hardware 
requirements are in the EPROM PROGRAMMING section of this manual. 

MCS BASIC-52 can save more than one program in an EPROM. In fact, it can save as many programs 
as the size of the EPROM memory permits. The programs are stored sequentially in the EPROM and any 
program can be retrieved and executed. This sequential storing of programs is referred to as the EPROM 
FILE. The following commands permit the user to generate and manipulate the EPROM FILE. 
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3.1 DESCRIPTION OF EPROM FILE COMMANDS 

COMMANDS: RAM(cr) and ROM [integer] (cr) 

ACTION TAKEN: 

These two commands tell the MCS BASIC-52 interpreter whether to select the current program (the current 
program is the one that will be displayed during a LIST command and executed when RUN is typed) out 
of RAM or EPROM. The RAM address is assumed to be 512 (200H) and the EPROM address begins at 
32, 784 (8010H). 

RAM 

When RAM(cr) is entered MCS BASIC-52 selects the current program from RAM MEMORY. This is 
usually considered the “normal” mode of operation and is the mode that most users interact with the 
command interpreter. 

ROM 

When ROM [integer] (cr) is entered MCS BASIC-52 selects the current program out of EPROM memory. 
If no integer is typed after the ROM command (i.e. ROM (cr)) MCS BASIC-52 defaults to ROM 1. Since 
the programs are stored sequentially in EPROM the integer following the ROM command selects which 
program the user wants to run or list. If you attempt to select a program that does not exist (i.e. you type 
in ROM 8 and only 6 programs are stored in the EPROM) the message ERROR: PROM MODE will be 
displayed. 

MCS BASIC-52 does not transfer the program from EPROM to RAM when the ROM mode is selected. 
So, you cannot EDIT a program in the ROM mode. If you attempt to edit a program in the ROM mode, 
by typing in a line number, the message ERROR: PROM MODE will be displayed. The following command 
to be described, XFER, permits one to transfer a program from EPROM to RAM for editing purposes. 

Since the ROM command does NOT transfer a program to RAM, it is possible to have different programs 
in ROM and RAM simultaneously. The user can “flip” back and forth between the two modes at any 
time. Another added benefit of NOT transferring a program to RAM is that all of the RAM memory can 
be used for variable storage if the PROGRAM is stored in EPROM. The SYSTEM CONTROL VALUES 
— MTOP and FREE always refer to RAM not EPROM. 

VARIATIONS: 

None. 
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3.2 DESCRIPTION OF EPROM FILE COMMANDS 

COMMAND: XF£R(cr) 

ACTION TAKEN: 

The XFER (transfer) command transfers the current selected program in EPROM to RAM and then selects 
the RAM mode. If XFER is typed while MCS BASIC-52 is in the RAM mode, the program stored in 
RAM is transferred back into RAM and the RAM mode is selected. The net result is that nothing happens 
except that a few milli-seconds of CPU time is used to do a wasted move. After the XFER command is 
executed, the user may edit the program in the same manner any RAM program may be edited. 

VARIATIONS: 

None. 
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3.3 DESCRIPTION OF EPROM FILE COMMANDS 

COMMAND: PROG(cr) 

ACTION TAKEN: 

The PROG COMMAND programs the resident EPROM with the current selected program. The current 
selected program may reside in either RAM or EPROM. This command assumes that the hardware is 
configured in the manner described in the EPROM PROGRAMMING section of this manual. 

After PROG (cr) is typed, MCS BASIC-52 displays the number in the EPROM FILE the program will 
occupy. 

EXAMPLE: 


>LIST 

10 

FOR lal 

TO 

10 

20 

PRINT I 



30 

NEXT I 



READY 

>PROO 




12 




READY 
>ROM 12 




READY 

>LIST 

10 

FOR 1=1 

TO 

10 

20 

PRINT I 



30 

NEXT I 



READY 

> 





In this example, the program just placed in the EPROM is the 12th program stored. 

VARIATIONS: 

None. 
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3.4 DESCRIPTION OF EPROM FILE COMMANDS 

COMMANDS: PROGl(cr) and PRGG2(cr) 

ACTION TAKEN: 

PROG1 

Normally, after power is applied to the MCS BASIC-52 device, the user MUST type a “space” character 
to initialize the 8052AH’s serial port. As a convenience, MCS BASIC-52 contains a PROGl COMMAND. 
What this command does is program the resident EPROM with the BAUD RATE information. So, the 
next time the MCS BASIC-52 device is “powered up,” i.e. RESET, the chip will read this information 
and initialize the serial port with the stored baud rate. The “sign-on” message will be sent to the console 
immediately after the MCS BASIC-52 device completes its reset sequence. The “space” character no 
longer needs to be typed. Of course, if the BAUD rate on the console device is changed a new EPROM 
must be programmed to make MCS BASIC-52 compatible with the new console. 

PROG2 

The PROG2 command does everything the PROGl command does, but instead of “signing-on” and 
entering the COMMAND MODE, the MCS BASIC-52 device immediately begins executing the first 
program stored in the resident EPROM. 

THIS IS AN IMPORTANT FEATURE!! 

By using the PROG2 command it is possible to RUN a program from a RESET condition and NEVER 
connect the MCS BASIC-52 chip to a console. In essence, saving PROG2 information is equivalent to 
typing a ROM 1, RUN command sequence. This is ideal for control applications, where it is not always 
possible to have a terminal present. In addition, this feature permits the user to write a special initialization 
sequence in BASIC or ASSEMBLY LANGUAGE and generate a custom “sign-on” message for specific 
applications. 
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3.5 DESCRIPTION OF EPROM FILE COMMANDS 

COMMANDS: FPROG(cr), FPROGl(cr), AND FPROG2(cr) 

ACTION TAKEN: 

FPROG(cr), FPROGl(cr), and FPROG2(cr) do exactly the same thing as PROG(cr), PROGl(cr), and 
PROG2(cr) respectively, except that the algorithm used to perform the programming function is the INTEL 
“INTELLIGENT” fast programming algorithm. The user MUST provide a way to increase VCC to the 
EPROM to 6 volts. 
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3.6 DESCRIPTION OF EPROM FILE COMMANDS 

COMMANDS: PROG3(cr), PROG4(cr), FPROG3(cr), FPROG4(er) (VERSION 1.1 ONLY) 

ACTION TAKEN: 

PROG3 

The PROGS COMMAND functions the same way as the PROGl COMMAND previously described, except 
that PROGS also saves the system control value, MTOP, when it is evoked. During a RESET or power- 
up sequence MCS BASIC-52 will only clear the external data memory up to the MTOP value that was 
saved when the PROGS COMMAND was evoked. This permits the user to “protect” regions of memory 
from being cleared during a RESET or power-up condition. In typical use, the PROGS COMMAND 
assumes that the user is saving some critical information if some type of battery-backed-up or non-volitle 
memory and does not want this information to be destroyed during a RESET or power-up sequence. 

PROG4 

The PROG4 COMMAND is a combination of the PROG2 and PROGS COMMAND. PROG4 saves the 
same information as PROGS, but also executes the first program stored in the EPROM after a RESET or 
power-up condition. 

FPROG3andFPROG4 

The FPROGS and FPROG4 commands save the same information as the PROGS and PROG4 commands 
respectively, except that the INTELligent^'* algorithm is used to program the EPROM. 

VARIATIONS: 

None. 
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3.7 DESCRIPTION OF EPROM FILE COMMANDS 

COMMANDS: PROG5(cr), PROG6(cr), FPROG5(cr), FPROG6(cr) (VERSION 1.1 ONLY) 

ACTION TAKEN: 

PROGS & FPROG5 

The PROG5 command saves both the baud rate information and the MTOP information, just like the 
PROG3 command previously described. However, during a RESET or power-up condition the MCS 
BASIC-52 device examines external data memory location 5FH (95 decimal). If the user has placed the 
value 0A5H (165 decimal) in this location, the MCS BASIC-52 device will not clear the external memory 
during a RESET or power-up condition. This permits the user to “save” programs in external memory, 
providing some type of battery back-up scheme has been employed. 

Normally, when using the PROG5 command to establish the RESET or power-up condition, the MCS 
BASIC-52 device will enter the command mode after RESET or power-up. However, if the user wishes 
to execute the program stored in external memory, the character 34H (52 decimal) needs to be placed in 
external memory location 5EH (94 decimal). Placing a 34H in location 5EH causes MCS BASIC-52 to 
enter the “RUN TRAP MODE.” Details of this mode are presented in chapter 8 of this manual. 

PROG6 & FPROG6 

Does the same thing as PROG5, but CALLS external program memory location 4039H during a RESET 
or power-up sequence. This option also requires the user to put the character 0A5H in external memory 
location 5FH to insure that external RAM will not be cleared during RESET or power-up. The user must 
put an assembly language initialization routine in external code memory location 4039H or else this RESET 
mode will crash. When the user returns from the customized assembly language RESET routine, three 
options exist: 

OPTION 1 FOR PROG6 

If the CARRY BIT is CLEARED (CARRY = 0) upon return from the user RESET routine MCS BASIC-52 
will enter the auto-baud rate determining routine. The user must then type a space character (20H) on the 
terminal to complete the RESET routine and produce a RESET message on the terminal. 

OPTION 2 FOR PROG6 

If the CARRY BIT is SET (CARRY = 1) and BIT 0 of the ACCUMULATOR is CLEARED (ACC. 0 
= 0) MCS BASIC-52 will produce the standard sign-on message upon return from the user supplied 
RESET routine. The baud rate will be the one that was saved when the PROG6 option was used. 

OPTION 3 FOR PROG6 

If the CARRY BIT is SET (CARRY = 1) and BIT 0 of the ACCUMULATOR is SET (ACC. 0 = 1), 
MCS BASIC-52 will execute the first program stored by the user in EPROM (starting address of the 
program is 801 OH) upon return from the user supplied RESET routine. 
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4.1 DESCRIPTION OF STATEMENTS 

STATEMENT: BAUD [expr] 

MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 

The BAUD [expr] statement is used to set the baud rate for the software line printer port resident on the 
MCS BASIC-52 device. In order for this STATEMENT to properly calculate the baud rate, the crystal 
(special function operator — XTAL) must be correctly assigned (e.g. XTAL = 900(XX)0). MCS BASIC-52 
assumes a crystal value of 11.0592 MHz if no XTAL value is assigned. The software line printer port is 
PI.7 on the 8052AH device. The main purpose of the software line printer port is to let the user make a 
“hard copy” of program listings and/or data. The COMMAND LIST# and the STATEMENT PRINT# 
direct outputs to the software line printer port. If the BAUD [expr] STATEMENT is not executed before 
a LIST# or PRINT# command/statement is entered, the output to the software line printer port will be 
at about 1 BAUD and it will take A LONG TIME to output something. You may even think that BASIC 
has crashed, but it hasn’t. It’s just outputting at a VERY SLOW rate. So be sure to assign a BAUD r^te 
to the software printer port BEFORE using LIST# or PRINT#. The maximum baud rate that can be 
assigned by the BAUD statement depends on the crystal. In general, 4800 is a reasonable maximum baud 
rate, however the user may want to experiment with different rates. The software serial transmits 8 data 
bits, 1 start bit, and two stop bits. No parity is transmitted, 

EXAMPLE: 


BAUD 1200 

Will cause the line printer port to output data at 1200 BAUD. 


VARIATIONS: 

None. 
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4.2 DESCRIPTION OF STATEMENTS 

STATEMENT: CALL [integer] 

MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 

The CALL [integer] STATEMENT is used to call an assembly language program. The integer following 
CALL is the address where the user must provide the assembly language routine. To return to BASIC the 
user must execute an assembly language RET instruction. Examples of how to use the CALL [integer] 
instruction are given in the ASSEMBLY LANGUAGE LINKAGE section of this manual. 

EXAMPLE: 


CALL 9000H 


Will cause the 8052AH to execute the assembly language program beginning at location 9000H (i.e. the 
program counter will be loaded with 9000H). 

VARIATIONS: (VERSION 1.1 ONLY) 

If the integer following the CALL statement is between 0 and 127 (7FH), Version 1.1 of MCS BASIC-52 
will multiply the user integer by two, then add 4100H and vector to that location. This means that CALL 
0 will call location 4100H, CALL 1 will call 4102H, CALL 2 — 4104H and so on. This permits the user 
to generate a simple table of assembly language routines without having to enter 4 digit hex integers after 
the CALL statement from the user supplied RESET routine. 
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4.3 DESCRIPTION OF STATEMENTS 

STATEMENT: CLEAR 

MODE: COMMAND AND/OR RUN 

TYPE: CONTROL 

The CLEAR STATEMENT sets all variables equal to 0 and resets all BASIC evoked interrupts and stacks. 
This means that after the CLEAR statement is executed an ONEXl or QNTIME statement must be executed 
before MCS BASIC-52 will acknowledge interrupts. ERROR trapping via the ONERR statement will also 
not occur until an ONERR[integer] STATEMENT is executed. The CLEAR STATEMENT does not affect 
the real time clock that is enabled by the CLOCK 1 STATEMENT. CLEAR also does not reset the memory 
that has been allocated for STRINGS, so it is NOT necessary to enter the STRING [expr], [expr] STATE¬ 
MENT to re-allocate memory for strings after the CLEAR STATEMENT is executed. In general, CLEAR 
is simply used to “erase” all variables. 

VARIATIONS: 

None. 
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4.4 DESCRIPTION OF STATEMENTS 

STATEMENTS: CLEARI (clear interrupts) 

CLEARS (clear stacks) 

MODE: COMMAND AND/OR RUN 

TYPE: CONTROL 

CLEARI 

The CLEARI STATEMENT clears all of the BASIC evoked interrupts. Specifically, the ONTIME and 
ONEXl interrupts are DISABLED after the CLEARI STATEMENT is executed. This is accomplished by 
clearing bits 2 and 3 of the 8052AH’s special function register, IE and by clearing the status bits that 
determine whether MCS BASIC-52 or the user is controlling these interrupts. The real time clock which 
is enabled by the CLOCK 1 STATEMENT is not affected by CLEARI. This statement can be used to 
selectively DISABLE interrupts during specific sections of the users BASIC program. The ONTIME and/ 
or ONEXl STATEMENTS MUST BE EXECUTED AGAIN before the specific interrupts will be enabled. 

CLEARS 

The CLEARS statement RESETS all of MCS BASIC-52’s STACKS. The CONTROL and ARGUMENT 
STACKS are reset to their initialization value, 254 (OFEH) and 510 (IFEH) respectively. The INTERNAL 
STACK (the 8052AH’s STACK POINTER, SPECIAL FUNCTION REGISTER-SP) is loaded with the 
value that is in INTERNAL RAM location 62 (3EH). This statement can be used to “purge” the stack 
should an error occur in a subroutine. In addition, this statement can be used to provide a “special” exit 
from a FOR-NEXT, DO-WHILE, or DO-UNTIL loop. 

EXAMPLE OF CLEARS: 


>10 PRINT “MULTIPLICATION TEST, YOU HAVE 0 SECONDS” 

>20 FOR I « 2 TO 9 

>30 N » INT(RND*10) : A • N*I 

>40 PRINT ”WHAT IS ”i N, I,: CLOCKl 

>S0 TIME « 0 : ONTIME 5,200 : INPUT R: IF ROA THEN 100 

>60 PRINT "THAT'S RlOHT”:TIME-0:NEXT I 

>70 PRINT "YOU DID IT, GOOD JOB":END 

>100 PRINT "WRONG, TRY AGAIN":GOTO 90 

>200 REM WASTE CONTROL STACK, TOO MUCH TIME 

>210 CLEARS:PRINT "YOU TOOK TOO LONG":GOTO 10 


NOTE: When the CLEARS and CLEARI STATEMENTS are LISTED they wfll appear as CLEAR S 
and CLEAR 1 respectively. Don’t be alarmed, that is the way it’s supposed to work. 
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4.5 DESCRIPTION OF STATEMENTS 

STATEMENTS: CLOCKl and CLOCKO 
MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 
CLOCKl 

The CLOCK! STATEMENT ehahles the REAL TIME CLOCK feature resident on the MGS BASlG-52 
device. The special function operator TIME is incremented once every 5 milliseconds after the CLOCKl 
STATEMENT has been executed. The CLOCKl STATEMENT uses TIMER/COUNTER 0 in the 13-bit 
mode to generate an interrupt once every 5 milliseconds. Because of this, the special function operator 
TIME has a resolution of 5 milliseconds. 

MCS BASIC-52 automatically calculates the proper reload value for TIMER/GOUNTER 0 after the crystal 
value has been assigned (i.e. XTAL - value). If no crystal value is assigned, MCS BASIC-52 assumes a 
value of 11.0592 MHz. The special function operator TIME counts from 0 to 65535.995 seconds. After 
reaching a count of 65535.995 seconds TIME overflows back to a count of zero. Because the CLOCKl 
STATEMENT uses the interrupts associated with TIMER/COUNTER 0 (the CLOCKl statement sets bits 
7 and 2 in the 8052AH’s special function register, IE), the user may not use this interrupt in an assembly 
language routine if the CLOCKl STATEMENT is executed in BASIC. The interrupts associated with the 
CLOCKl STATEMENT cause MCS BASIC-52 programs to run at about 99.6% of normal speed. That 
means that the interrupt handling for the REAL TIME CLOCK feature only consumes about .4% of the 
total CPU time. This very small interrupt overhead is attributed to the very fast and effective interrupt 
handling of the 8052AH device. 

CLOCKO 

The CLOCKO (zero) STATEMENT disables or “turns off’ the REAL TIME CLOCK feature. This 
statement clears bit 2 in the 8052AH’s special function register, IE. After CLOCKO is executed, the special 
function operator TIME will no longer increment. The CLOCKO STATEMENT also returns control of the 
interrupts associated with TIMER/COUNTER 0 back to the user, so this interrupt may be handled at the 
assembly language level. CLOCKO is the only MCS B ASIC-52 statement that can disable the REAL TIME 
CLOCK. CLEAR and CLEARI will NOT disable the REAL TIME CLOCK. 

VARIATIONS: 

None. 
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4.6 DESCRIPTION OF STATEMENTS 

STATEMENTS: DATA — READ — RESTORE 

MODE: RUN 

TYPE: ASSIGNMENT 

DATA 

DATA specifies expressions that may be retrieved by a READ STATEMENT. If multiple expressions per 
line are used, they MUST be separated by a comma. 

READ 


READ retrieves the expressions that are specified in the DATA STATEMENT and assigns the value of 
the expression to the variable in the READ STATEMENT. The READ STATEMENT MUST ALWAYS 
be followed by one or more variables. If more than one variable follows a READ STATEMENT, they 
MUST be separated by a comma. 

RESTORE 

RESTORE “resets” the internal read pointer back to the beginning of the data so that it may be read 
again. 


EXAMPLE: 


>10 FOR I»1 TO 3 
>20 READ AaB 
>30 PRINT A, B 
>40 NEXT I 
>50 RESTORE 
>60 READ Ai B 
>70 PRINT A, B 

>80 DATA 10,20,10/2,20/2iSIN<PI)fC0S(PI> 
>RUN 

10 20 
5 10 

0 -1 
10 20 


VARIATIONS: 


None. 
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4.6 DESCRIPTION OF STATEMENTS 

Explanation of previous example: 

Everytime a READ STATEMENT is encountered the next consecutive expression in the DATA STATE¬ 
MENT is evaluated and assigned to the variable in the READ STATEMENT. DATA STATEMENTS may 
be placed anywhere within a program, they will NOT be executed nor will they cause an eiror. DATA 
STATEMENTS are considered to be chained together and appear to be one BIG DATA STATEMENT. 
If at anytime all the DATA has been read and another READ STATEMENT is executed then the program 
is terminated and the message ERROR: NO DATA — IN LINE XX is printed to the console device. 
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4.7 DESCRIPTION OF STATEMENTS 
STATEMENT: DIM 
MODE: COMMAND AND/OR RUN 
TYPE: ASSIGNMENT 

DIM reserves storage for matrices. The storage area is first assumed to be zero. Matrices in MCS BASIC- 
52 may have only ONE DIMENSION and the size of the dimensioned array MAY NOT exceed 254 
elements. Once a variable is dimensioned in a program it may not be re-dimensioned. An attempt to re¬ 
dimension an array will cause an ARRAY SIZE ERROR. If an arrayed variable is used that has NOT been 
dimensioned by the DIM STATEMENT, BASIC will assign a default value of 10 to the array size. All 
arrays are set equal to zero when the RUN COMMAND, NEW COMMAND, or the CLEAR STATEMENT 
is executed. The number of bytes allocated for an array is 6 times the (array size plus 1). So, the array 
A(IOO) would require 606 bytes of storage. Memory size usually limits the size of a dimensioned array. 

VARIATIONS: 

More than one variable can be dimensioned by a single DIM STATEMENT, i.e., DIM A(10), B(15), 
Al(20). 

EXAMPLE: 


DEFAULT ERROR ON ATTEMPT TO RE-DIMENSION ARRAY 

MO A(5)«10 - BASIC ASSIGNS DEFAULT OF 10 TO ARRAY SIZE HERE 

>20 DIM A<5) - ARRAY CANNOT BE RE-DIMENSIONED 

:>RUN 

ERROR: ARRAY SIZE - IN LINE 20 

20 DIM A<5) 

-X 
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STATEMENTS: DO — UNTIL [rel expr] 

MODE: RUN 
TYPE: CONTROL 

The DO — UNTIL [rel expr} instruction provides a means of “loop control” within an MCS BASIC-52 
program. All statements bietween the DO and the UNTIL [rel expr] will be executed until the relational 
expression following the UNTIL statement is TRUE. DO — UNTIL loops may be nested. 

EXAMPLES: 


SIMPLE DO-UNTIL 

NESTED 

DO-UNTIL 


V 

o 

> 

i 

o 

>10 DO 

: A*A4-i : DO 

B-B+1 

>20 OQ 

>20 PRINT A, B. A#B 


>30 A«A4-1 

>30 UNTIL B»3 


>40 PRINT A 

>40 B*0 


>30 UNTIL A-4 

>50 UNTIL A*3 


>60 PRINT "DONE" 

>RUN 

>RUN 




1 1 

1 


X 

1 2 

2 


2 

1 3 

3 


3 

2 1 

2 


4 

2 2 

4 


DONE 

2 3 

6 



3 1 

3 


READY 

3 2 

6 


> 

3 3 

9 



READY 

> 




VARIATIONS: 

None 
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STATEMENTS: DO — WHILE [rel expr] 

MODE: RUN 
TYPE: CONTROL 

The DO — WHILE [rel expr] instruction provides a means of “loop control” within an MCS BASIC-52 
program. This operation of this statement is similar to the DO — UNTIL [rel expr] except that all statements 
between the DO and the WHILE [rel expr] will be executed as long as the relational expression following 
the WHILE statement is true. DO — WHILE and DO — UNTIL statements can be nested. 

EXAMPLES: 


SIMPLE DO-WHILE 

NESTED DO-WHILE - DO-UNTIL 

MO DO 

>10 DO : AaA+t : 

>20 AaA-i-1 

>20 PRINT A, B,A*B 

:>30 PRINT A 

>30 WHILE B03 

>40 WHILE A<:4 

>40 B*0 

>50 PRINT “DONE'* 

>50 UNTIL A*3 

>RUN 

>RUN 

1 

111 

2 

12 2 

3 

13 3 

4 

2 12 ^ 

DONE 

2 2 4 

2 3 6 

READY 

3 13 

> 

3 2 6 

3 3 9 

READY 


> 


VARIATIONS: 


None 
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4.10 DESCRIPTION OF STATEMENTS 

STATEMENT: END 
MODE: RUN 
TYPE: CONTROL 

The END STATEMENT terminates program execution. The continue command, CONT will not operate 
if the END STATEMENT is used to terminate execution (i.e., a CAN’T CONTINUE ERROR will be 
printed to the console). The last statement in an MCS BASIC-52 program will automatically terminate 
program execution if no END STATEMENT is used. 

EXAMPLES: 


LAST STATEMENT 

TERMINATION 

END STATEMENT TERMINATION 

>10 FOR 1*1 TO 

4 

>10 FOR 1*1 TO 4 

>20 PRINT I 


>20 GOSUS 100 

>30 NEXT I 


>30 NEXT I 

>RUN 


>40 END 
>100 PRINT I 

1 


>110 RETURN 

2 


>RUN 

3 



4 


1 



2 

READY 


3 

> 


4 



READY 

> 


VARIATIONS: 


None 
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4.11 DESCRIPTION OF STATEMENTS 

STATEMENTS: FOR — TO — {STEP} — NEXT 

MODE: RUN VERSION 1.0 (COMMAND AND/OR RUN in Version 1.1) 

TYPE: CONTROL 

The FOR — TO — {STEP} — NEXT STATEMENTS are used to set up and control loops. 

EXAMPLE: 


10 FOR A«B TO C STEP D 
20 PRINT A 
30 NEXT A 


If B = 0, C= 10, and D = 2, the PRINT STATEMENT at line 20 will be executed 6 times. The values of 
“A” that will be printed are 0, 2, 4, 6, 8, 10. “A” represents the name of the index or loop counter. 
The value of “B” is the starting value of the index, the value of “C” is the limit value of the index, and 
the value of “D” is the increment to the index. If the STEP STATEMENT and the value “D” are omitted, 
the increment value defaults to 1, therefore, STEP is an optional statement. The NEXT STATEMENT 
causes the value of “D” to be added to the index. The index is then compared to the value of “C,” the 
limit. If the index is less than or equal to the limit, control will be transferred back to the statement after 
the FOR STATEMENT. Stepping “backwards” (i.e. FOR I = 100 TO 1 STEP-1) is permitted in MCS 
BASIC-52. Unlike some BASICS, the index MAY NOT be omitted from the NEXT STATEMENT in 
MCS BASIC-52 (i.e. the NEXT statement MUST always be followed by the appropriate variable). 

EXAMPLES: 


>10 FOR 1=1 TO 4 

>10 FOR 1=0 TO 8 STEP 2 

>20 PRINT I 

>20 PRINT I 

>30 NEXT I 

>30 NEXT I 

>RUN 

>RUN 

1 

0 

2 

2 

3 

4 

4 

6 


a 

READY 



READY 
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In Version 1.1 of MCS BASIC-52 it is possible execute the FOR-TO-{STEP}4^IEXT stat®ent in th^ 
Command Mode. This makes it possible for the user to do things like display regions of memory by writing 
a short program like FOR 1 = 512 TO 560: PHO. XBY(I),: NEXT I. It may also have other usesy biitttey 
haven’t been thought of. 

Also Version 1.1 allows the NEXT statement to be used without a variable following the statement. This 
means that programs like: 

EXAMPLE: 


10 FOR I » 1 TO 100 
20 PRINT I 
30 NEXT 


Are permitted ih Version 1.1 of MCS BASIC-52. The variable associated with the NEXT is always assumed 
to be the variable used in the last FOR statement. 
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4.12 DESCRIPTION OF STATEMENTS 
STATEMENTS: GOSUB[ln num] — RETURN 
MODE: RUN 
TYPE: CONTROL 
GOSUB 


The GOSUB [In num] STATEMENT will cause MCS BASIC-52 to transfer control of the program directly 
to the line number ([In num]) following the GOSUB STATEMENT. In addition, the GOSUB STATEMENT 
saves the location of the STATEMENT following GOSUB on the control stack so that a RETURN 
STATEMENT can be performed to return control. 

RETURN 

This statement is used to “return” control back to the STATEMENT following the most recently executed 
GOSUB STATEMENT. The GOSUB-RETURN sequence can be “nested” meaning that a subroutine 
called by the GOSUB STATEMENT can call another subroutine with another GOSUB STATEMENT. 

EXAMPLES: 


SIMPLE SUBROUTINE 

NESTED SUBROUTINES 

MO FOR 1*1 TO S 

>10 FOR 1*1 TO 3 

>20 QOSUB 100 

>20 GOSUB 100 

>30 NEXT I 

>30 NEXT I 

>100 PRINT I 

>40 END 

MIO return 

>100 PRINT I, 

>RUN 

>110 GOSUB 200 

1 

>120 RETURN 
>200 PRINT !♦! 

2 

>210 RETURN 

3 

>RUN 

4 

5 

1 1 

READY 

2 4 

3 9 

> 

READY 

> 
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4.12 DESCRIPTION OF STATEMENTS , 

NOTE — The Control Stack on Version 1.1 permits a graceful exit from incompleted control loops, given 
the following example: 

EXAMPLE: 


50 GOSUB 1000 


1000 FOR I » 1 TO 10 
1010 IF X « I THEN 1040 
1020 PRINT I*X 
1030 NEXT I 
1040 RETURN 


Version 1.1 would permit the programmer to exit the subroutine even though the FOR-NEXT loop might 
not be allowed to complete if X did equal I. Version 1.0 of MCS BASIC-52 would yield a C-STACK 
error if the FOR-NEXT loop was not allowed to complete before the RETURN statement was executed. 
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4.13 DESCRIPTION OF STATEMENTS 

STATEMENT: GOTO [In num] 

MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 

The GOTO [In num] STATEMENT will cause BASIC to transfer control directly to the line number 
([In num]) following the GOTO STATEMENT. 

EXAMPLE: 


50 GOTO 100 


Will, if line 100 exists, cause execution of the program to resume at line 100. If line number 100 does 
not exist the message ERROR: INVALID LINE NUMBER will be printed to the console device. 

Unlike the RUN COMMAND the GOTO STATEMENT, if executed in the COMMAND MODE, does 
not CLEAR the variable storage space or interrupts. However, if the GOTO STATEMENT is executed in 
the COMMAND MODE after a line has been edited, MCS BASIC-52 will CLEAR the variable storage 
space and all BASIC evoked interrupts. This is a necessity because the variable storage and the BASIC 
program reside in the same RAM memory. So editing a program can destroy variables. 

NOTE — (Version 1.0 only) 

Because of the way MCS BASIC-52’s text interpreter processes a line, when an INVALID LINE NUMBER 
ERROR occurs on the GOTO, GOSUB, ON GOTO, and ON GOSUB STATEMENTS the line AFTER 
the GOTO or GOSUB STATEMENT will be printed out in the error message. This may be confusing, 
but it was a trade-off between execution speed, code size, and error handling. Error handling lost. 

EXAMPLE: 


:> 10 GOTO 100 
:>20 PRINT X 
:>RUN 


ERROR: INVALID LINE NUMBER - IN LINE 20 

20 PRINT X 
-X 


Version 1.1 does not exhibit this particular anomaly. 
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4.14 DESCRIPTION OF STATEMENTS 

STATEMENTS: ON [expr] GOTO[ln num], [In num], . . . [In num] 

ON [expr] GOSUB[ln num], [In num], ... [In num] 

MODE: RUN 
TYPE: CONTROL 

The value of the expression following the ON statement is the number in the line list that control will be 
transferred to. 

EXAMPLE: 


10 ON Q GOTO 100.200,300 


If Q was equal to 0, control would be transferred to line number 100. If Q was equal to 1, control would 
be transferred to line number 200. If Q was equal to 2, GOTO line 300, etc. All comments that apply to 
GOTO and GOSUB apply to the ON STATEMENT. If Q is less than ZERO a BAD ARGUMENT ERROR 
will be generated. If Q is greater than the line number list following the GOTO or GOSUB STATEMENT, 
a BAD SYNTAX ERROR will be generated. The ON STATEMENT provides “conditional branching” 
options within the constructs of an MCS BASIC-52 program. 
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4.15 DESCRIPTION OF STATEMENTS 

STATEMENTS: IF — THEN — ELSE 
MODE: RUN 
TYPE: CONTROL 

The IF statement sets up a conditional test. The generalized form of the IF — THEN — ELSE statement 
is as follows: 

[In num] IF [rel expr] THEN valid STATEMENT ELSE valid STATEMENT 
A specific example is as follows: 

MO IF A»100 THEN A*0 ELSE A=A+1 


Upon execution of line 10 IF A is equal to 100, THEN A would be assigned a value of 0. IF A does not 
equal 100, A would be assigned a value of A + 1. If it is desired to transfer control to different line numbers 
using the IF statement, the GOTO statement may be omitted. The following examples would yield the 
same results: 


>20 IF I NT (AX 10 THEN GOTO 100 ELSE GOTO 200 
>20 IF INT(AX 10 THEN 100 ELSE 200 


Additionally, the THEN statement can be replaced by any valid MCS BASIC-52 statement, as shown 
below: 


>30 

IF 

AO 10 

THEN PRINT A 

ELSE 10 

>30 

IF 

AO 10 

PRINT A ELSE 

10 


The ELSE statement may be omitted. If it is, control will pass to the next statement. 

EXAMPLE: 


>20 IF A*10 THEN 40 
>30 PRINT A 


In this example, IF A equals 10 then control would be passed to line number 40. If A does not equal 10 
line number 30 would be executed. 


45 














MCS® BASiC-52 


iny 


4.15 DESCRIPTION OF STATEMENTS 

COMMENTS ON IF-THEN-ELSE- 


Version 1.1 is not compatible with VI.0 when the IF_THEN—ELSE STATEMENT is used with multiple 
statements per line. In V 1.0, the following two examples would function in the same manner. 


EXAMPLE 1: 


10 

IF A=B THEN C«A 

A«A/2 

GOTO 100 

20 

PRINT A 




EXAMPLE 2: 


10 IF A«B THEN C=A 
12 A*A/2 
14 GOTO 100 
20 PRINT A 


They function in the same manner because Vl.O treats the delimiter (:) exactly the same as a carriage 
return (cr) in every case. However, Vl.l executes the remainder of the line if and only if the test A = B 
proves to be true. This means in EXAMPLE 1 IF A did equal B, Vl.l would then set C = A, then set 
A = A/2, then execute line 100. IF A did not equal B, VI. 1 would then PRINT A and ignore the statements 
C = A : A = A/2 : GOTO 100. Vl.l will execute EXAMPLE 2 exactly the same way as Vl.O. This same 
logical interpretation holds true for the ELSE statement as well. This example dictates a simple rule for 
maintaining IF_-THEN__ELSE compatibility between the two versions. IF THE DELIMITER (:) IS NOT 
USED IN AN IF_THEN__ELSE STATEMENT, Vl.O AND Vl.l WILL TREAT THE STATEMENTS 
IN THE SAME MANNER!! 

This change was made because most users of MCS BASIC-52 felt that the Vl.l interpretation of this 
statement was more useful because fewer GOTO statements need be employed in a typical program. 
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4.16 DESCRIPTION OF STATEMENTS 

STATEMENTS: INPUT 

MODE: RUN 

TYPE: INPUT/OUTPUT 

The INPUT statement allows users to enter data from the console during program execution. One or more 
variables may be assigned data with a single input statement. The variables must be separated by a comma. 

EXAMPLE: 


INPUT Ai Q 


Would cause the printing of a question mark (?) on the console device as a prompt to the operator to input 
two numbers separated by a comma. If the operator does not enter enough data, then MCS BASIC-52 
responds by outputting the message TRY AGAIN to the console device. 

EXAMPLE: 


>10 INPUT A, B 
>20 PRINT AiB 
>RUN 

?1 

TRY AGAIN 

? 1,2 

1 2 

READY 


The INPUT statement may be written so that a descriptive prompt is printed to tell the user what to type. 
The message to be printed is placed in quotes after the INPUT statement. If a comma appears before the 
first variable on the input list, the question mark prompt character will not be displayed. 

EXAMPLES: 


>10 INPUT“ENTER A NUMBER“A 
>20 PRINT SQR(A) 

>RUr4 

ENTER A NUMBER 
?100 
10 


>10 INPUT“ENTER A NUMBER~“;A 
>20 PRINT SQR(A) 

>RUN 

ENTER A NUMBER-100 
10 
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4.16 DESCRIPTION OF STATEMENTS 

Strings can also be assigned with an INPUT statement. Strings are always terminated with a carriage returh 
(cr). So, if more than one string input is requested with a single INPUT statement, MCS BASIC-52 will 
prompt the user with a question mark. 

EXAMPLES: 


>10 STRING 110, 10 

>10 STRING 110, 10 

>20 INPUT "NAME: ",$(1) 

>20 INPUT "NAMES: ",$(1),$(2) 

>30 PRINT "HI ",$<!) 

>30 PRINT "HI AND ",*(2) 

>RUN 

>RUN 

NAME; SUSAN 

NAMES: BILL 

HI SUSAN 

?ANN 


HI BILL AND ANN 

READY 



READY 


Additionally, strings and variables can be assigned with a single INPUT statement. 

EXAMPLE: 


>10 STRING 100.10 

>20 INPUT’‘NAME<CR). AGE - ".$(1).A 

>30 PRINT "HELLO ".^<1).". YOU ARE A. "YEARS OLD" 
>RUf-4 

NAME(CR), AGE - FRED 
?15 

HELLO FRED. YOU ARE 15 YEARS OLD 

READY 

> 
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STATEMENT: LET 
MODE: COMMAND AND/OR RUN 
TYPE: ASSIGNMENT 

The LET statement is used to assign a variable to the value of an expression. The generalized form of 
LET is: 

LET [var] = [expr] 

EXAMPLES: 


LET A » 10*SIN<B)/100 or 
LET A = A 1 


Note that the = sign used in the LET statement is not equality operator, but rather a “replacement” 
operator and that the statement should be read A is replaced by A plus one. THE WORD LET IS ALWAYS 
OPTIONAL, i.e. 


LET A a 2 is the same as A = 2 


When LET is omitted the LET statement is called an IMPLIED LET. This document will use the word 
LET to refer to both the LET statement and the IMPLIED LET statement. 

The LET statement is also used to assign the string variables, i.e: 

LET ♦<l) = '*THIS IS A STRING” or 
LET ♦<2)*^<1) 


Before Strings can be assigned the STRING [expr], [expr] STATEMENT MUST be executed, or else a 
MEMORY ALLOCATION ERROR will occur. 

SPECIAL FUNCTION VALUES can also be assigned by the LET statement, i.e.: 


LET IE = 82H or 

LET XBYTE<2000H)=5AH or 

LET DBYTE(25>*XBYTE(1000) 
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4.18 DESCRIPTION OF STATEMENTS 

STATEMENT: ONERR[ln num] 

MODE: RUN 
TYPE: CONTROL 

The ONERR[ln num] statement lets the programmer handle arithmetic errors, should they occur, during 
program execution. Only ARITH. OVERFLOW, ARITH. UNDERFLOW, DIVIDE BY ZERO, and BAD 
ARGUMENT errors can be “trapped” by the ONERR statement, all other errors are not. If an arithmetic 
error occurs after the ONERR statement is executed, the MCS BASIC-52 interpreter will pass control to 
the line number following the ONERR[ln num] statement. The programmer can handle the error condition 
in any manner suitable to the particular application. Typically, the ONERR[ln num] statement should be 
viewed as an easy way to handle errors that occur when the user provides inappropriate data to an INPUT 
statement. 

With the ONERR[ln num] statement, the programmer has the option of determining what type of error 
occurred. This is done by examining external memory location 257 (lOlH) after the error condition is 
trapped. The error codes are as follows: 


ERROR 

CODE 

a 

10 - 

ERROR 

CODE 

= 

20 - 

ERROR 

CODE 

a 

30 - 

ERROR 

CODE 

a 

40 - 


DIVIDE BY ZERO 
ARITH. OVERFLOW 
ARITH. UNDERFLOW 
BAD ARGUMENT 


This location may be examined by using an XBY(257) statement. 
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4.19 DESCRIPTION OF STATEMENTS 

STATEMENT: ONEXl [In num] 

MODE: RUN 
TYPE: CONTROL 

The ONEXl [In num] statement lets the user handle interrupts on the 8052AH’s INTI pin with a BASIC 
program. The line number following the ONEXl statement tells the MCS BASIC-52 interpreter which line 
to pass control to when an interrupt occurs. In essence, the ONEXl statement “forces” a GOSUB to the 
line number following the ONEXl statement when the INTI pin on the 8052AH is pulled low. The 
programmer must execute a RETI statement to exit from the ONEXl interrupt routine. If this is not done 
all future interrupts on the INTI pin will be “locked out” and ignored until a RETI is executed. 

The ONEXl statement sets bits 7 and 2 of the 8052AH’s interrupt enable register IE. Before an interrupt 
can be processed, the MCS BASIC-52 interpreter must complete execution of the staement it is currently 
processing. Because of this, interrupt latency can vary from microseconds to tens of milliseconds. The 
ONTIME [expr], [In num] interrupt has priority over the ONEXl interrupt. So, the ONTIME interrupt 
can intermpt the ONEXl interrupt routine. 
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4.20 DESCRIPTION OF STATEMENTS 


STATEMENT: ONTIME [expr], [In num] 

MODE: RUN 
TYPE: CONTROL 

Since MCS BASIC-52 processes a line in the millisecond time frame and the timer/counters on the 8052AH 
operate in the micro-second time frame, there is an inherent incompatibility between the timer/counters on 
the 8052AH and MCS BASIC-52. To help solve this situation the ONTIME [expr], [In num] statement 
was devised. What ONTIME does is generate an interrupt everytime the SPECIAL FUNCTION OPER¬ 
ATOR, TIME, is equal to or greater than the expression following the ONTIME statement. Actually, only 
the integer portion of TIME is compared to the integer portion of the expression. The interrupt forces a 
GOSUB to the line number ([In num]) following the expression ([expr]) in the ONTIME statement. 

Since the ONTIME statement uses the SPECIAL FUNCTION OPERATOR, TIME, the CLOCKI statement 
must be executed in order for ONTIME to operate. If CLOCKI is not executed the SPECIAL FUNCTION 
OPERATOR, TIME, will never increment and not much will happen. 


Since the ONTIME statement generates an interrupt when TIME is greater than or equal to the expression 
following the ONTIME statement, how can periodic interrupts be generated? That’s easy, the ONTIME 
statement must be executed again in the interrupt routine: 

EXAMPLE: 


>10 TIMEaO : CLOCKI : ONTIME 2 , 100 : DO 
>20 WHILE TIME<10 : END 

>100 PRINT "TIMER INTERRUPT AT -'S TIME."SECONDS" 

>110 ONTIME TIME+2.100 : RETI 

>RUN 


TIMER INTERRUPT AT 
TIMER INTERRUPT AT 
TIMER INTERRUPT AT 
TIMER INTERRUPT AT 
TIMER INTERRUPT AT 


2.045 SECONDS 
4.045 SECONDS 
6. 045 SECONDS 
8.045 SECONDS 
10. 045 SECONDS 


READY 


You may wonder why the TIME that was printed out was 45 milliseconds greater than the time that the 
interrupt was supposed to be generated. That’s because the terminal used in this example was running at 
4800 BAUD and it takes about 45 milliseconds to print the message TIMER INTERRUPT AT ”. 
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4.20 DESCRIPTION OF STATEMENTS 

If the programmer does not want this delay, a variable should be assigned to the SPECIAL FUNCTION 
OPERATOR, TIME, at the beginning of the interrupt routine. 

EXAMPLE: 


MO TIME»0 : CLOCKl 

: ONTIME 2. 100: DO 

>20 WHILE TIME<10 : 

END 

>100 

A-TIME 


>110 

PRINT "TIMER INTERRUPT AT A,"SECONDS" 

>120 

ONTIME A-H2, 100 

: RETI 

>RUN 



TIMER 

INTERRUPT AT - 

2 SECONDS 

TIMER 

INTERRUPT AT - 

4 SECONDS 

TIMER 

INTERRUPT AT - 

6 SECONDS 

TIMER 

INTERRUPT AT - 

a SECONDS 

TIMER 

INTERRUPT AT - 

10 SECONDS 

READY 




Like the ONEXl statement, the ONTIME interrupt routine must be exited with a RETI statement. Failure 
to do this will “lock-out” all future interrrupts. 

The ONTIME interrupt has priority over the ONEXl interrupt. This means that the ONTIME interrupt can 
interrupt the ONEXl interrupt routine. This priority was established because time related functions in 
control applications were viewed as critical routines. If the user does not want the ONEXl routine to be 
interrupted by the ONTIME interrupt, a CLOCKO or a CLEARI statement should be executed at the 
beginning of the ONEXl routine. The interrupts would have to be re-enabled before the end of the ONEXl 
routine. The ONEXl interrupt cannot interrupt an ONTIME routine. 

The ONTIME statement in MCS BASIC-52 is unique, relative to most BASICS. This powerful statement 
eliminates the need for the user to “test” the value of the TIME operator periodically throughout the 
BASIC program. 
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4.21 DESCRIPTION OF STATEMENTS 

STATEMENT: PRINT or P. (? VERSION 1.1 ONLY) 

MODE: COMMAND and/or RUN 
TYPE: INPUT/OUTPUT 

The PRINT statement directs MCS BASIC-52 to output to the console device. The value of expressions, 
strings, literal values, variables or test strings may be printed out. The various forms may be combined in 
the print list by separating them with commas. If the list is terminated with a comma, the carriage return/ 
line feed will be suppressed. P. is a “shorthand” notation for PRINT. In Version 1.1 ? is also “shorthand” 
notation for PRINT. 

EXAMPLES: 


:>PRINT 10*10/3*3 

:>PRINT "MCS-Sl" 

>PRINT 5/1E3 

100 9 

MCS-51 

3 1000 


Values are printed next to one another with two intervening blanks. A PRINT statement with no arguments 
causes a carriage retum/line feed sequence to be sent to the console device. 

SPECIAL PRII^T FORMATTING STATEMENTS 

TAB([expr]) 

The TAB([expr]) function is used in the PRINT statement to cause data to be printed out in exact locations 
on the output device. TAB([expr]) tells MCS BASIC-52 which position to begin printing the next value 
in the print list. If the printhead or cursor is on or beyond the specified TAB position, MCS BASIC-52 
will ignore the TAB function. 

EXAMPLE: 


>PRINT TAB(5)f '‘X", tab (10)/ "Y" 
X Y 


SPC([expr]) 

The SPC([expr]) function is used in the PRINT statement to cause MCS BASIC-52 to output the number 
of spaces in the SPC argument. 

EXAMPLE: 


>PRINT A/SPC(5)/ B 


may be used to place an additional 5 spaces between the A and B over and above the two that would 
normally be printed. 
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4.21 DESCRIPTION OF STATEMENTS 

CR 


The CR function is interesting and unique to MCS BASIC-52. When CR is used in a PRINT statement it 
will force a carriage return, but no line feed. This can be used to create one line on a CRT device that is 
repeatedly updated. 

EXAMPLE: 


>10 FOR 1*1 TO 1000 
>20 PRINT I,CRi 
>30 NEXT I 


will cause the output to remain only on one line. No line feed will ever be sent to the console device. 

USING(special characters) 

The USING function is used to tell MCS BASIC-52 what format to display the values that are printed. 
MCS BASIC-52 “stores” the desired format after the USING statement is executed. So, all outputs 
following a USING statement will be in the format evoked by the last USING statement executed. The 
USING statement need not be executed within every PRINT statement unless the programmer wants to 
change the format. U. is a “shorthand” notation for USING. The options for USING are as follows: 

USING(Fx) — This will force MCS BASIC-52 to output all numbers using the floating point format. The 
value of X determines how many significant digits will be printed. If x equals 0, MCS 
BASIC-52 will not output any trailing zeros, so the number of digits will vary depending 
upon the number. MCS BASIC-52 will always output at least 3 significant digits even if 
X is 1 or 2. The maximum value for x is 8. 


EXAMPLE: 


>10 PRINT USING(F3).1.2.3 
>20 PRINT USIN0(F4),1,2.3 
>30 PRINT USIN0(F5), li 2, 3 
>40 FOR 1*10 TO 40 STEP 10 
>50 PRINT I 
>60 NEXT I 
>RUN 

1. 00 E 0 2. 00 E 0 3. 00 E 0 

1. 000 E 0 2. 000 E 0 3. 000 E 0 

1. 0000 E 0 2. 0000 E 0 3. 0000 E 0 

1.0000 E4-1 

2. 0000 E -^1 
3.0000 E^l 
4. 0000 E-»*l 

READY 
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USING(#.#) — This will force MCS BASlC-52 to output all numbers using an integer and/or ffactibn 
format. The number of “#” ’s before the decimal point represents the number of sig¬ 
nificant integer digits that will be printed in the fraction. The detirriar point miy be 
omitted, in which case only integers will be printed. USING may be abbreviated U. 
USING (###.###), USING(######) and USING(######:##) *e alU^ 
in MCS BASIC-52. The maximum number of “#” characters is 8. If MCS BASIC-52 
cannot output the value in the desired format (usually because the value is too large) a 
question mark (?) will be printed to console device, then BASIC will output the number 
in the FREE FORMAT described below. 

EXAMPLE: 


MO PRINT USING(##. ##),!, 2. 3 
:>20 FOR 1*1 TO 120 STEP 20 
>30 PRINT I 
>40 NEXT I 
>RUN 

1.00 2.00 3.00 

1 . 00 
21.00 
41. 00 
61.00 
ai. 00 
? 101 

READY 


NOTE: The USING(Fx) and the USING(#.#) formats will always “align” the decimal points when 
printing a number. This feature makes displayed columns of numbers easy to read. 

USING(O) -— This argument lets MCS BASIC-52 determine what format to use. The rules are simple, if 
the number is between ±99999999 and ± .1, BASIC will display integers and fractions. If 
it is out of this range, BASIC will use the USING(FO) format. Leading and trailing zeros 
will always be suppressed. After reset, MCS BASIC-52 is placed in the USING(O) format. 


56 






MCS® BASIC-52 


iny 


4.22 DESCRIPTION OF STATEMENTS 

STATEMENT: PRINT# or P.# (?# VERSION 1.1 ONLY) 

MODE: COMMAND and/or RUN 
TYPE: INPUT/OUTPUT 

The PRINT#, P.#, and ?# (in Version 1.1 only) statement does the same thing as the PRINT, P. and ? 
(in Version 1.1 only) statement except that the output is directed to the list device instead of the console 
device. The BAUD rate to the list device must be initialized by the STATEMENT — BAUD[expr] before 
the PRINT#, P.#, or, ?# statement is used. All comments that apply to the PRINT, P. or, ? statement 
apply to the PRINT#, P.#, or ? statement. P.# and ?# (in Version 1.1 only) are “shorthand” notations 
for PRINT#. 
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4.23 DESCRIPTION OF STATEMENTS 

STATEMENTS: PHO., PHI., PHO.#, PHI.# 

MODE: COMMAND and/or RUN 
TYPE: INPUT/OUTPUT 

The PHO. and PHI. statements do the same thing as the PRINT statement except that the values are printed 
out in a hexadecimal format. The PHO. statement suppresses two leading zeros if the number to be printed 
is less than 255 (OFFH). The PHI. statement always prints out four hexadecimal digits. The character 
“H” is always printed after the number when PHO. or PHI. is used to direct an output. The values printed 
are always truncated integers. If the number to be printed is not within the range of valid integer (i.e. 
between 0 and 65535 (OFFFFH) inclusive), MCS BASIC-52 will default to the normal mode of print. If 
this happens no “H” will be printed out after the value. Since integers can be entered in either decimal 
or hexadecimal form the statements PRINT, PHO., and PHI, can be used to perform decimal to hexadecimal 
and hexadecimal to decimal conversion. All comments that apply to the PRINT statement apply to the 
PHO. and PHI. statements. PHO.# and PHI.# do the same thing as PHO. and PHI. respectively, except 
that the output is directed to the list device instead of the console device. 

EXAMPLES: 


:>PHO. 2*2 

>PH1. 2*2 

>PRINT 99H 

>PHO. 

100 

04H 

0004H 

153 

64H 


>PHO. 1000 

>PHl. 1000 

>P. 3E8H 

>PHO. 

PI 

3E8H 

03E8H 

1000 

03H 
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4.24 DESCRIPTION OF STATEMENTS 

STATEMENT: PRINT®, PH0.@, PHI.® (VERSION 1.1 ONLY) 

MODE: COMMAND AND/OR RUN 
TYPE: INPUT/OUTPUT 

The PRINT® (P.® OR ?@), PH0.@, and PHI.® statements do the same thing as the PRINT (P.@ or 
?®), PHO., and PHI. statements respectively except that the output is directed to a user defined output 
driver. These statements assume that the user has placed an assembly language output routine in external 
code memory location 403CH. To enable the ® driver routine the user must SET BIT 27H (39D) in the 
internal memory of the MCS BASIC-52 device. BIT 27H (39D) is BIT 7 of internal memory location 24H 
(36D). This BIT can be set by the BASIC statement DBY(24H) = DBY(24H).OR. 80H or by a user supplied 
assembly language routine. If the user evokes the ® driver routine and this bit is not set, the output will 
be directed to the console driver. The only reason this BIT must be set to enable the @ driver is that it 
adds a certain degree of protection from accidently typing LIST® when no assembly language routine 
exist. The philosophy here is that if the user sets the bit, the user provides the driver or else!!! 

When MCS BASIC-52 calls the user output driver routine at location 403CH, the byte to output is in the 
accumulator and R5 of register bank 0 (RBO). The user may modify the accumulator (A) and the data 
pointer (DPTR) in the assembly language output routine, but cannot modify any of the registers in RBO. 
This is intended to make it real easy for the user to implement a parallel or serial output driver without 
having to do a PUSH or a POP. 
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4.25 DESCRIPTION OF STATEMENTS 

STATEMENT: PUSH[expr] 

MODE: COMMAND AND / OR RUN 
TYPE: ASSIGNMENT 


The arithmetic expression, or expressions following the PUSH statement are evaluated and then sequentially 
placed on MCS BASIC-52’s ARGUMENT STACK. This statement, in conjunction with the POP statement 
provide a simple means of passing parameters to assembly language routines. In addition, the PUSH and 
POP statements can be used to pass parameters to BASIC subroutines and to “SWAP” variables. The last 
value PUSHED onto the ARGUMENT STACK will be the first value POPPED off the ARGUMENT 
STACK. 

VARIATIONS: 


More than one expression can be pushed onto the ARGUMENT stack with a single PUSH statement. The 

expressions are simply followed by a comma: PUSH[expr],[expr],.[expr]. The last value PUSHED 

onto the ARGUMENT STACK will be the last expression [expr] encountered in the PUSH STATEMENT. 

EXAMPLES: 


SWAPPING 

SUBROUTINE 

VARIABLES 

PASSING 

MO AalO 

>10 PUSH li 3. 2 

:>20 Ba20 

>20 GOSUB 100 

>30 PRINT Ai B 

>30 POP RliR2 

>40 PUSH A, B 

>40 PRINT RliR2 

>50 POP Ai B 

>50 END 

>60 PRINT Ai B 

>100 REM QUADRATIC Aa2iBa3i 0*1 IN EXAMPLE 

>RUN 

>110 POP Ai Bi C 


>120 PUSH (-B-i-SQRCB^B-A^A^C) )/<2-»A) 

10 20 

>130 PUSH (-B-SQR(B*B-4*A*C >)/< 2*A) 

20 10 

>140 RETURN 


>RUN 

READY 


> 

-1 5 


READY 


> 
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4.26 DESCRIPTION OF STATEMENTS 

STATEMENT: POP[var] 

MODE: COMMAND AND / OR RUN 
TYPE: ASSIGNMENT 

The top of the ARGUMENT STACK is assigned to the variable following the POP statement and the 
ARGUMENT STACK is “POPPED” (i.e. incremented by 6). Values can be placed on the stack by either 
the PUSH statement or by assembly language CALLS. NOTE — If a POP statement is executed and no 
number is on the ARGUMENT STACK, an A-STACK ERROR will occur. 

VARIATIONS: 

More than one variable can be popped off the ARGUMENT stack with a single POP statement. The 
variables are simply followed by a comma (i.e. POP [var],[var],.[var]). 

EXAMPLES: 


See PUSH statement. 


COMMENT: 

The PUSH and POP statements are unique to MCS BASIC-52. These powerful statements can be used to 
“get around” the GLOBAL variable problems so often encountered in BASIC PROGRAMS. This problem 
arises because in BASIC the “main” program and all subroutines used by the main program are required 
to use the same variable names (i.e. GLOBAL VARIABLES). It is not always convenient to use the same 
variables in a subroutine as in the main program and you often see programs re-assign a number of variables 
(i.e. A = Q) before a GOSUB STATEMENT is executed. If the user reserves some variable names JUST 
for subroutines (i.e. SI, S2) and passes variables on the stack as shown in the previous example, you will 
avoid any GLOBAL variable problems in MCS BASIC-52. 
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4.27 DESCRIPTION OF STATEMENTS 

STATEMENT: PWM [expr], [expr], [expr] 

MODE: COMMAND and/or RUN 
TYPE: INPUT/OUTPUT 

PWM stands for PULSE WIDTH MODULATION. What it does is generate a user defined pulse sequence 
on PI.2 (bit 2 of I/O PORT 1) of the MCS BASIC-52 device. The first expression following the PWM 
statement is the number of clock cycles the pulse will remain high. A clock cycle is equal to 12/XTAL, 
which is 1.085 microseconds at 11.0592 MHz. The second expression is the number of clock cycles the 
pulse will remain low and the third expression is the total number of cycles the user wishes to output. All 
expressions in the PWM statement must be valid integers (i.e. between 0 and 65535 (OFFFFH) inclusive). 
Additionally, the minimum value for the first two expressions in the PWM statement is 25. 

The PWM statement can be used to create “audiable” feedback in a system. In addition, just for fun, the 
programmer can play music using the PWM statement. More details about using the PWM statement are 
in the appendix. 

EXAMPLE: 


>PWM 100, 100, 1000 


At 11.0592 MHz would generate 1000 cycles of a square wave that has a period of 217 microseconds 
(4608 Hz) on PI.2. 
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4.28 DESCRIPTION OF STATEMENTS 

STATEMENT; REM 

MODE: RUN (Version 1.0) COMMAND AND/OR RUN (Version 1.1) 

TYPE: CONTROL — PERFORMS NO OPERATION 

REM is short for REMark. It does nothing, but allows the user to add comments to a program. Comments 
are usually needed to make a program a little easier to understand. Once a REM statement appears on a 
line the entire line is assumed to be a remark, so a REM statement may not be terminated by a colon (:), 
however, it may be placed after a colon. This can be used to allow the programmer to place a comment 
on each line. 


EXAMPLES: 


>10 REM INPUT ONE VARIABLE 
>20 INPUT A 

>30 REM INPUT ANOTHER VARIABLE 
>40 INPUT B 

>50 REM MULTIPLY THE TWO 
>60 Z=A»B 

>70 REM PRINT THE ANSWER 
>80 PRINT Z 


>10 INPUT A : REM INPUT ONE VARIABLE 
>20 INPUT 3 : REM INPUT ANOTHER VARIABLE 
>30 Z=A*B ; REM MULTIPLY THE TWO 
>40 PRINT Z : REM PRINT THE ANSWER 


The following will NOT work because the entire line would be interpreted as a REMark, so the PRINT 
statement would not be executed: 


>10 REM PRINT THE NUMBER : PRINT A 


note — The reason the REM statement was made executable in the command mode in Version 1.1 of 
MCS BASIC-52 is that if the user is employing some type of UPLOAD/DOWNLOAD routine with a 
computer, this lets the user insert REM statements, without line numbers in the text and not download 
them to the MCS BASIC-52 device. This helps to conserve memory. 
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4.29 DESCRIPTION OF STATEMENTS 

STATEMENT: RETI 
MODE: RUN 
TYPE: CONTROL 

The RETI statement is used to exit from interrupts that are handled by an MGS BASIC-52 program. 
Specifically, the ONTIME and the ONEXl interrupts. The RETI statement does the same thing as the 
RETURN statement except that it also clears a software interrupt flags so interrupts can again be acknowl¬ 
edged. If the user fails to execute the RETI statement in the interrupt procedure, all future interrupts will 
be ignored. 
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4.30 DESCRIPTION OF STATEMENTS 

STATEMENT: STOP 
MODE: RUN 
TYPE: CONTROL 

The STOP statement allows the programmer to break program execution at specific points in a program. 
After a program is STOPped variables can be displayed and/or modified. Program execution may be 
resumed with a CONTinue command. The purpose of the STOP statement is to allow for easy program 
“debugging.” More details of the STOP-CONT sequence are covered in the DESCRIPTION OF COM¬ 
MAND — CONT section of this manual. 

EXAMPLE: 


>10 FOR I»1 TO 100 

>20 PRINT I 

>30 STOP 

>40 NEXT I 

>RUN 

1 

STOP - IN LINE 40 

READY 

>C0NT 

2 


Note that the line number printed out after the STOP statement is executed is the line number following 
the STOP statement, NOT the line number that contains the STOP statement!!! 
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4.31 DESCRIPTION OF STATEMENTS 

STATEMENT: STRING [expr], [expr] 

MODE: COMMAND and/or RUN 
TYPE: CONTROL 

The STRING [expr],[expr] statement allocates memory for strings. Initially, no memory is allocated for 
strings. If the user attempts to define a string with a statement such as LET $(!) = “HELLO” before 
memory has been allocated for strings, a MEMORY ALLOCATION ERROR will be generated. The first 
expression in the STRING [expr],[expr] statement is the total number of bytes the user wishes to allocate 
for string storage. The second expression denotes the maximum number of bytes that are in each string. 
These two numbers determine the total number of defined string variables. 

You might think that the total number of defined strings would be equal to the first expression in the 
STRING [expr],[expr] statement divided by the second expression. Ha,ha, do not be so presumptuous. 
MCS BASIC-52 requires one additional byte for each string, plus one additional byte overall. This irieans 
that the statement STRING 100,10 would allocate enough memory for 9 string variables, ranging from 
$(0) to $(8) and all of the 100 allocated bytes would be used. Note that $(0) is a valid string in MCS 
BASIC-52. 

After memory is allocated for string storage, neither commands, such as NEW nor statements, such as 
CLEAR, will “de-allocate” this memory. The only way memory can be de-allocated is to execute a 
STRING 0,0 statement. STRING 0,0 will allocate no memory to string variables. 


IMPORTANT NOTE 


Every time the STRING [expr],[expr] statement is executed, MCS BASIC-52 executes the equivalent of 
a CLEAR statement. This is a necessity because string variables and numeric variables occupy the same 
external memory space. So, after the STRING statement is executed, all variables are “ wiped-out. ’ ’ Because 
of this, string memory allocation should be performed early in a program (like the first statement or so) 
and string memory should never be “re-allocated” unless the programmer is willing to destroy all defined 
variables. 
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STATEMENTS: UIl and UIO (USER INPUT) 

MODE: COMMAND and/or RUN 

TYPE: CONTROL 

UIl 

The UIl statement permits the user to write specific console input drivers for MCS BASIC-52. After UIl 
is executed BASIC will call external program memory location 4033H when a console input is requested. 
The user must provide a JUMP instruction to an ASSEMBLY LANGUAGE INPUT ROUTINE at this 
location. The appropriate ASCII input from this routine is placed in the 8052AH’s accumulator and the 
user input routine returns back to BASIC by executing an ASSEMBLY LANGUAGE RET instruction. 
The user must NOT modify any of the 8052AH’s registers in the assembly language program with the 
exception of the MEMORY and REGISTER BANK allocated to the USER. THE ASSEMBLY LAN¬ 
GUAGE LINKAGE section of this manual explains what memory MCS BASIC-52 allocates to the user 
and how the user may allocate additional memory if needed. 

In addition to providing the INPUT driver routine for the UIl statement, the user must also provide a 
CONSOLE STATUS CHECK routine. This routine checks to see if the CONSOLE DEVICE has a character 
ready for MCS BASIC-52 to read. BASIC CALLS external memory location 4036H to check the CONSOLE 
STATUS. The CONSOLE STATUS ROUTINE sets the CARRY BIT to 1 (C= 1) if a character is ready 
for BASIC to read and CLEARS the CARRY BIT (C = 0) if no character is ready. Again, the contents of 
the REGISTERS must not be changed. MCS BASIC-52 uses the CONSOLE STATUS CHECK routine 
to examine the keyboard for a control-C character during program execution and during a program LISTING. 
This routine is also used to perform the GET operation. 

UIO 

The UIO statement assigns the console input console routine back to the software drivers resident on the 
MCS BASIC-52 device. UIO and UIl may be placed anywhere within a program. This allows the BASIC 
program to accept inputs from different devices at different times. 

NOTE: The UIO and UIl function is controlled by BIT 30 (lEH) in the 8052AH’s internal memory. BIT 
30 is in internal memory location 35.6 (23.6H) i.e. the sixth bit in internal memory location 35 (23H). 
When BIT 30 is SET (BIT 30 = 1), the user routine will be called. When BIT 30 is CLEARED (BIT 30 
= 0), the MCS BASIC-52 input driver routine will be used. The assembly language programmer can use 
this information to change the input device selection in assembly language. 
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4.33 DESCRIPTION OF STATEMENTS 

STATEMENTS: UOI and UOO (USER OUTPUT) 

MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 
U01 ■ 

The UOl STATEMENT permits the user t6 write specific conMe output drivers for MCS BASIC-52. 
After UOl is executed BASIC will call external program memory location 4030H when a console output 
is requested. The user must provide a JUMP instruction to an ASSEMBLY LANGUAGE OUTPUT 
ROUTINE at this location. MCS BASIC-52 places the output character in REGISTER 5 (R5) of REGISTER 
BANK 0 (RBO). The user returns back to BASIC executing an assembly language RET instruction. The 
user must NOT mbdify any of the 8052AH’s REGISTERS, including the ACCUMULATOR during the 
user output procedure with the exception of the MEMORY and REGISTER BANK allocated to the user. 
UOl gives the user the freedom to write custom output routines for MGS BASIC-52. 

uoo 

UOO STATEMENT assigns the cohsole output routine back to the software drivers resident on the MCS 
BASIC-52 device. UOO and UOl may be placed anywhere within a program. This allows the BASIC 
program to output characters to different devices at different times. 

NOTE: The UOO and UOl function is controlled by BIT 28 (ICH) in the 8052AH’s internal memory. 
BIT 28 is in the internal memory location 35.4 (23.4H), i.e. the fourth bit in the internal memory location 
35 (28H). When BIT 28 is SET (BIT 28 = 1), the user routines will be called. When BIT 28 is cleared, 
(BIT 28 = 0), the MCS BASIC-52 output drivers will be used. The assembly language programmer can 
use this information to change the output device selection in assembly language. 
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4.34 DESCRIPTION OF STATEMENTS 

STATEMENT: IDLE (VERSION 1.1 ONLY) 

MODE: RUN 
TYPE: CONTROL 

The IDLE statement forces the MCS BASIC-52 device into a “wait until interrupt mode.” Execution of 
statements is halted until either an ONTIME [expr], [In num] or an ONEXl [In num] interrupt is received. 
The user must make sure that one or both of these interrupts have been enabled before executing the IDLE 
instruction or else the MCS BASIC-52 device will enter a “wait forever mode” and for all practical 
purposes the system will have crashed. 

When an ONTIME [expr], [In num] or an ONEXl [In num] is received while in the IDLE mode, the MCS 
BASIC-52 device will execute the interrupt routine, then execute the statement following the IDLE in¬ 
struction. Hence, the execution of the IDLE instruction is terminated when an interrupt is received. 

While in the IDLE mode, the MCS BASIC-52 device asserts the /DMA ACKNOWLEDGE pin (PORT 1, 
BIT 6 = 0) to indicate that the IDLE instruction is active and that no external bus activity will occur. 
This PIN is physically pin 7 on the MCS BASIC-52 device. When the MCS BASIC-52 device exits from 
the IDLE mode, this pin is placed back into the logically 1 (non-active) state. 

The user may also exit from the IDLE mode with an assembly language interrupt routine. This is accom¬ 
plished by setting BIT 33 (21H) (which is in Bit addressable RAM location 36.1) when returning from 
the assembly language interrupt routine. If this bit is not set by the user, the MCS BASIC-52 device wijl 
remain in the IDLE mode when the user assembly language routine returns to BASIC. 

An attempt to execute the IDLE statement in the direct mode will yield a BAD SYNTAX ERROR. 
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4.35 DESCRIPTION OF STATEMENTS 

STATEMENT: RRQM [interger] (VERSION 1.1 ONLY) 

MODE: COMMAND AND/OR RUN 
TYPE: CONTROL 

RROM stands for RUN ROM. What it does is select a program in the EPROM file, then execute the 
program. The integer after the RROM statement selects what program in the EPROM file is to be executed. 
In the COMMAND mode RROM 2 would be equivalent to typing ROM 2, then RUN. But, notice that 
RROM [integer] is a statement. This means that a program that is already executing can actually force the 
execution of a completely different program that is in the EPROM file. This gives the user the ability to 
“change programs” on the fly. 

If the user executes a RROM [integer] statement and an invalid integer is entered (say 6 programs are 
contained in the EPROM file and the user enters RROM 8, or no EPROM is in the system), no error will 
be generated and MCS BASIC-52 will execute the statement following the RROM [integer] statement. 

NOTE — Every time the RROM [integer] statement is executed, all variables and strings are set equal to 
zero, so variables and strings CANNOT be passed from one program to another by using the RROM 
[integer] statement. Additionally, all MCS BASIC-52 evoked interrupts are cleared. 
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4.36 DESCRIPTION OF STATEMENTS 

STATEMENTS: LD@ [expr] and ST@ [expr] (VERSION 1.1 ONLY) 

MODE: COMMAND AND/OR RUN 
TYPE: INPUT/OUTPUT 

ST@ 

The ST@ [expr] statement lets the user specify where MCS BASIC-52 floating point numbers are to be 
stored. The expression [expr] following the ST@ statement specifies the address of where the number is 
to be stored and the number is assumed to be on the argument stack. The ST@ [expr] statement is 
designed to be used in conjunction with the LD@ [expr] statement. The purpose of these two statements 
is to allow the user to save floating point numbers anywhere in memory with the assumption that the user 
will employ some type of battery back-up or non-volatile scheme with this memory. 

LD@ 


The LD(a) [expr] statement lets the user retrieve floating point numbers that were saved with the ST@ 
[expr] statement. The expression [expr] following the LD@ statement specifies where the number is stored 
and after executing the LD@ [expr] statement, the number is placed on the argument stack. 


EXAMPLE: Saving and retrieving a ten element array at location array at location OFOOOH 


10 

REM ARRAY SAVE *** 


20 

FOR I « 0 TO 9 


30 

PUSH A<I) : REM PUT ARRAY VALUE ON 

STACK 

40 

ST® 0F005H+6»I : REM STORE IT. SIX 

BYTES PER NUMBER 

50 

NEXT I 


60 

REM OET ARRAY *** 


70 

FOR I » 0 TO 9 


80 

LD® 0F005H+6*! 


90 

POP B(I) 


100 

NEXT I 



Remember that each floating point number requires 6 bytes of storage. Also note that expression in the 
ST@ [expr] and LD@ [expr] statements point to the most significant byte of the stored number. Hence, 
ST@ (0F005H) would save the number in locations 0F005H, 0F004H, 0F003H, 0F002H, OFOOIH, and 
OFOOOH. 
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4-37 DESCRIPTION OF STATEMENTS 
STATEMENT: PGM 
MODE: COMMAND AND/OR RUN 
TYPE: INPUT/OUTPUT 

The PGM statement gives the user the ability to program an EPROM or EEPROM while executing a 
BASIC program. The PGM statement requires that the user set up internal memory locations 18H 
(24D), 19H (25D), lAH (26D), IBH (27H), lEH (30D) and IGH (31D). Note that these internal memory 
locations are normally reserved for the user!! 

The User must initialize these internal memory locations with the following: 

EXAMPLE: 


LOCATION 

CONTENTS 

IBH:19H 
<27D:25D) 

THE ADDRESS OF THE SOURCE INFORMATION THAT IS TO BE 
PROGRAMMED INTO THE EPROM , LOCATION 19H IS THE LOW 

BYTE AND LOCATION IBH IS THE HIGH BYTE 

lAH:18H 
(26D:24D) 

THE ADDRESS - 1 OF THE EPROM LOCATION(S) THAT ARE TO 

BE PROGRAMMED, LOCATION 18H IS TH LOW BYTE AND 

LOCATION lAH IS THE HIGH BYTE 

IFH:lEH 
<31D: 30D) 

THE NUMBER OF BYTES THAT THE USER WANTS TO PROGRAM 

LOCATION lEH IS THE LOW BYTE AND LOCATION IFH IS 

THE HIGH BYTE 


The user must also initialize the width of the desired EPROM programming pulse and store the value in 
internal memory locations 40H (64D) (high byte) and 41H (65D) (low byte). The reload for a 50 millisecond 
EPROM programming pulse is calculated as follows: 


10 REM R = RELOAD VALUE, W = WIDTH IN SECONDS <50 MILLISECONDS) 

20 W « . 05 

30 R « 65536 - W * XTAL/12 

40 DBY(40H) « R/256 

50 DBY(41H> « R .AND. OFFH 


In addition, the user must also SET or CLEAR BIT 38.3 (26.3H) to select the INTELligent EPROM 
programming algorithm. The Bit is SET to select INTELligent programming and CLEARED to select the 
normal 50 millisecond algorithm. To SET the BIT, execute a DBY(38) = DBY(38) .OR. 8H Statement, 
to CLEAR the BIT, execute a DBY(38) = DBY(38) .AND, 0F7H instruction. 
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4.3 7 DESCRIPTION OF STATEMENTS 

riMPORTANT NOTE! 

When executed in the RUN mode, The PGM statement will not generate an error if the EPROM fails to 
program properly. Instead, the control of the program will be passed back to the user just as if the EPROM 
programmed properly. The user must then examine locations lEH and IFH. If the contents of locations 
lEH and IFH both equal zero, then the EPROM programmed properly. If they do not, then an ERROR 
occurred during the programming process. The user can then examine locations 1AH:18H to determine 
what location in the EPROM failed to program. 

Well, this sounds like a lot to do just to program an EPROM, but it’s not so bad. The following program 
is an example of a universal EPROM/EEPROM programmer built around MCS BASIC-52. This program 
can program a block of RAM into an EPROM or EEPROM that is addressed at 8000H or above. 


EXAMPLE: 


10 PRINT "UNIVERSAL PROM PROGRAMMER" : PRINT "WHAT TYPE OF DEVICE ?" 

20 PRINT PRINT "I « EEPROM" : PRINT "2 » INTELLIGENT EPROM" 

30 PRINT "3 *• NORMAL (50 MS) EPROM" : PRINT INPUT "TYPE (1,2,3) - ", T 

40 ON (T-1) GOSUB 340,350,360 

50 REM this sets up intelligent programming if needed 

60 IF W*. 001 THEN DBY(26)«DBY(26). OR. 8 ELSE DBY(26)*DBY(26). AND. 0F7H 

70 REM calculate pulse width and save it 

80 PUSH (65536-(WeXTAL/12)) : GOSUB 380 

90 POP G1 : DBY(40H)«G1 : POP G1 : DBY(41H)«G1 : PRINT 

100 INPUT " STARTING DATA ADDRESS - ",S : IF S<512. OR. S>OFFFFH THEN 100 

110 PRINT INPUT " ENDING DATA ADDRESS - ", E 

120 IF E<S. OR, E>OFFFFH THEN 110 

130 PRINT INPUT " PROM ADDRESS - ",P : IF P<8000H. OR. P>OFFFFH THEN 130 

140 REM calculate the number of bgtes to program 

150 PUSH (E-S)+l : GOSUB 380 : POP G1 : DBY(31)*G1 : POP G1 : DBY(30)»01 
160 REM set up the eprom address 

170 PUSH (P-1) : GOSUB 380 : POP G1 : DBY(26)*G1 : POP G1 : DBY(24)«01 
180 REM set up the source address 

190 PUSH S : GOSUB 380 : POP G1 : DBY(27)=01 : POP G1 : DBY(25)=G1 

200 PRINT PRINT "TYPE A 'CR' ON THE KEYBOARD WHEN READY TO PROGRAM" 

210 REM wait for a 'cr' then program the eprom 
220 X=0ET : IF XOODH THEN 220 
230 REM program the eprom 
240 PGM 

250 REM see if any errors 

260 IF (DBY(30). OR. DBY(31))«0 THEN PRINT "PROGRAMMING COMPLETE" : END 

270 PRINT PRINT "♦**ERROR***ERROR***ERRORe**" : PRINT 

280 REM these routines calculate the address of the source and 

290 REM eprom location that failed to program 

300 S1«DBY(25)+256*DBY(27) : S1«S1-1 : D1*DBY(24)+256*DBY(26) 

310 PHO. "THE VALUE ",XBY(S1), : PHI. " WAS READ AT LOCATION ", SI : PRINT 

320 PHO. "THE EPROM READ ",XBY(D1), : PHI. " AT LOCATION ", D1 : END 

330 REM these subroutines set up the pulse width 

340 W«. 0005 : RETURN 

350 W«.001 : RETURN 

360 W». 05 : RETURN 

370 REM this routine takes the top of stack and returns high, low bytes 
380 POP G1 : PUSH (Gl. AND. OFFH) : PUSH (INT(Gl/256)) : RETURN 
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CHAPTERS 

Description of Arithmetic/Logic Operators and Expressions 


5.1 DUAL OPERAND OPERATORS 

MCS BASIC-52 contains a complete set of arithmetical and logical operators. Operators are divided into 
two groups, dual operand or dyadic operators and single operand or unary operators. The generalized form 
of all dual operand instructions is as follows: 

[expr] OP [expr] , where OP is one of the following operators: 

+ ADDITION OPERATOR 
EXAMPLE: 

PRINT 3-»-2 
5 


/ DIVISION OPERATOR 
EXAMPLE: 

PRINT 100/S 
20 


** EXPONENTIATION OPERATOR 

Raises the first expression to the power of the second expression. The power any number can be raised to 
is limited to 255. The notation ** was chosen instead of the sometimes used f symbol because the “up 
arrow” symbol appears different on various terminals. To eliminate confusion the ** notation was chosen. 

EXAMPLE: 


PRINT 2**3 
8 


* MULTIPLICATION OPERATOR 
EXAMPLE: 

PRINT 3*3 
9 


- SUBTRACTION OPERATOR 
EXAMPLE: 


PRINT 9-6 
3 
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S.1 DUAL OPERAND OPERATIONS 

.AND. LOGICAL AND OPERATOR 
EXAMPLE: 


PRINT 3. AND. 2 
2 


.OR. LOGICAL OR OPERATOR 
EXAMPLE: 


PRINT 1.OR.4 
5. 


.XOR. LOGICAL EXCLUSIVE OR OPERATOR 


EXAMPLE: 


PRINT 7. XOR. 6 
1 


COMMENTS ON LOGICAL OPERATORS .AND., .OR., and .XOR. 

These operators perform a BIT-WISE logical function on valid INTEGERS. That means both arguments 
for these operators must be between 0 and 65535 (OFFFFH) inclusive. If they are not, MCS BASIC-52 
will generate a BAD ARGUMENT ERROR. All non-integer values are truncated, NOT rounded. 

You may wonder why the notation .OP. was chosen for the logical functions. The only reason for this is 
that MCS BASIC-52 eliminates ALL spaces when it processes a user line and inserts spaces before and 
after STATEMENTS when it LISTS a user program. MCS BASIC-52 does not insert spaces before and 
after operators. So, if the user types in a line such as 10 A = 10 * 10, this line will be listed as 
10 A = 10*10. All spaces entered by the user before and after the operator will be eliminated. The .OP. 
notation was chosen for the logical operators because a line entered as 10 B = A AND B would be listed 
as 10 B = AANDB. This just looked confusing, so the dots were added to the logical instructions and the 
previous example would be listed as 10 B = A.AND.B, which is easier to read. 
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5.2.1 UNARY OPERATORS — GENERAL PURPOSE 

ABS([expr]) 

Returns the ABSOLUTE VALUE of the expression. 

EXAMPLES: 


PRINT ABS(5) PRINT ABS(-5> 

5 5 


NOT([expr]) 

Returns a 16 bit one’s complement of the expression. The expression must be a valid integer (i.e. between 
0 and 65535 (OFFFFH) inclusive). Non-integers will be truncated, not rounded. 

EXAMPLES: 


PRINT NOT(65000) 

PRINT NQTCO) 

535 

65535 


INT([expr]) 

Returns the integer portion of the expression. 


EXAMPLES: 


PRINT INT(3. 7) 

PRINT INTCIOO. 876) 

3 

100 


SGN([expr]) 

Will return a value of -I-1 if the argument is greater than zero, zero if the argument is equal to zero, and 
— 1 if the argument is less than zero. 

EXAMPLES: 


PRINT SON(52) 

PRINT SON(O) 

PRINT SON(-8) 

1 

0 

-1 
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5.2.1 UNARY OPERATORS — GENERAL PURPOSE 

SQR([expr]) 

Returns the square root of the argument. The argument may not be less than zero. The result returned will 
be accurate to within +/- a value of 5 on the least significant digit. 

EXAMPLES: 


PRINT SQR(9) 

PRINT SQR(45) 

PRINT SQR(100) 

3 

6.7082035 

10 


RND 

Returns a pseudo-random number in the range between 0 and 1 inclusive. The RND operator uses a 16- 
bit binary seed and generates 65536 pseudo-random numbers before repeating the sequence. The numbers 
generated are specifically between 0/65535 and 65535/65535 inclusive. Unlike most BASICS, the RND 
operator in MCS BASIC-52 does not require an argument or a dummy argument. In fact, if an argument 
is placed after the RND operator, a BAD SYNTAX error will occur. 

EXAMPLES: 


PRINT RND 
30270477 


PI 

PI is not really an operator, it is a stored constant. In MCS BASIC-52, PI is stored as 3.1415926. Math 
experts will notice that PI is actually closer to 3.141592653, so proper rounding for PI should yield the 
number 3.1415927. The reason MCS BASIC-52 uses a 6 instead of a 7 for the last digit is that errors in 
the SIN, COS and TAN operators were found to be greater when the 7 was used instead of 6. This is 
because the number PI/2 is needed for these calculations and it is desireable, for the sake of accuracy to 
have the equation PI/2 4 - PI/2 = PI hold true. This cannot be done if the last digit in PI is an odd number, 
so the last digit of PI was rounded to 6 instead of 7 to make these calculations more accurate. 
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5.2.2 UNARY OPERATORS— LOG FUNCTIONS 

LOG([expr]) 

Returns the natural logarithm of the argument. The argument must be greater than 0. This calculation is 
carried out to 7 significant digits. 

EXAMPLES: 


PRINT L0G(12) 

PRINT LQO(EXP<1)) 

2.484906 

1 


EXP([expr]) 

This function raises the number “e” (2.7182818) to the power of the argument. 

EXAMPLES: 


PRINT EXP(l) 

PRINT EXP<LQG(2)) 

2.7182818 

2 


5.2.3 UNARY OPERATORS — TRIG FUNCTIONS 

SIN([expr]) 

Returns the SIN of the argument. The argument is expressed in radians. Calculations are carried out to 7 
significant digits. The argument must be between ±200000. 

EXAMPLES: 


PRINT SIN(PI/4) 

PRINT SIN(O) 

.7071067 

0 


COS([expr]) 

Returns the COS of the argument. The argument is expressed in radians. Calculations are carried out to 
7 significant digits. The argument must be between ±200000. 

EXAMPLES: 


PRINT C0S(PI/4) 

PRINT COS(O) 

.7071067 

1 
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5.2.3 UNARY OPERATORS — TRIG FUNCTIONS 

TAN([expr]) 

Returns the TAN of the argument. The argument is expressed in radians. The argument must be between 

±200000. 

EXAMPLES; 


PRINT TAN(PI/4) 

PRINT TAN(O) 

1 

0 


ATN([expr]) 

Returns the ARCTANGENT of the argument. The result is in radians. Calculations are carried out to 7 
significant digits. The ATN operator returns a result between —PI/2 (3.1415926/2) and PI/2. 

EXAMPLES: 


PRINT ATN(PI) 

PRINT ATN(l) 

1.2626272 

. 78539804 


COMMENTS ON TRIG FUNCTIONS 

The SIN, COS, and TAN operators use a Taylor series to calculate the function. These operators first 
reduce the argument to a value that is between 0 and PI/2. This reduction is accomplished by the following 
equation: 

REDUCED ARGUMENT = (user arg/PI - INT(user arg/PI)) * PI 

The REDUCED ARGUMENT, from the above equation, will be between 0 and PI. The REDUCED 
ARGUMENT is then tested to see if it is greater than PI/2. If it is, then it is subtracted from PI to yield 
the final value. If it isn’t, then the REDUCED ARGUMENT is the final value. 

Although this method of angle reduction provides a simple and economical means of generating the 
appropriate arguments for a Taylor series, there is an accuracy problem associated with this technique. 
The accuracy problem is noticed when the user argument is large (i.e. greater than 1000). That is because 
significant digits, in the decimal (fraction) portion of REDUCED ARGUMENT are lost in the (user arg/PI 
— INT(user arg/PI)) expression. As a general rule, try to keep the arguments for the TRIG functions as 
small as possible! 
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5.3 UNDERSTANDING PRECEDENCE OF OPERATORS 

The hierarchy of mathematics dictates that some operations are carried out before others. If you understand 
the hierarchy of mathematics, it is possible to write complex expressions using only a minimum amount 
of parentheses. It’s easy to illustrate what precedence is all about, examine the following equation: 

4+3*2.= ? 

Should you add (4 + 3) then multiply seven by 2, or should you multiply (3*2) then add 4? Well, the 
hierarchy of mathematics says that multiplication has precedence over addition, so you would multiply 
(3*2) first then add 4. So, 

4 + 3*2 = 10 

The rules for the hierarchy of math are simple. When an expression is scanned from left to right an operation 
is not performed until an operator of lower or equal precedence is encountered. In the example addition 
could not be performed because multiplication has higher precedence. The precedence of operators from 
highest to lowest in MCS BASIC-52 is as follows: 

DOPERATORS THAT USE PARENTHESES () 

2) EXPONENTATION (**) 

3) NEGATION (-) 

4) MULTIPLICATION (*) AND DIVISION (/) 

5) ADDITION ( + ) AND SUBTRACTION (-) 

6) RELATIONAL EXPRESSIONS ( = ,<>,>,> = ,<,< = ) 

7) LOGICAL AND (.AND.) 

8) LOGICAL OR (.OR.) 

9) LOGICAL XOR (.XOR.) 

Relative to operator precedence, the rule of thumb should always be; when in doubt, use parentheses. 
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5.4 HOW RELATIONAL EXPRESSIONS WORK 

Relational expressions involve the operators = ,<>,>,> = ,<, and < = . These operators are typically 
used to “test” a condition. In MCS BASIC-52 relational operators return a result of 65535 (OFFFFH) if 
the relational expression is true, and a result of 0, if the relation expression is false. But, where is the 
result returned? It is returned to the argument stack. Because of this, it’s possible to actually display the 
result of a relational expression. 

EXAMPLES: 


PRINT 1=0 

PRINT 1>0 

PRINT AO A 

PRINT A=A 

0 

6S535 

0 

63535 


It may seem strange to have a relational expression actually return a result, but it offers a unique benefit 
in that relational expressions can actually be “chained” together using the logical operators .AND., .OR., 
and .XOR.. This makes it possible to test a rather complex condition with ONE statement. 

EXAMPLE: 


>10 IF A<B. AND. A>C. OR. A>D THEN 


Additionally, the NOT([expr]) operator can be used. 

EXAMPLE: 


>10 IF NOT(A>B). AND. A<C THEN, 


By “chaining” together relational expressions with logical operators, it is possible to test very particular 
conditions with one statement. When using logical operators to link together relational expressions, it is 
very important that the programmer pay careful attention to the precedence of operators. The logical 
operators were assigned lower precedence, relative to relational expressions, just to make the linking of 
relational expressions possible without using parentheses. 
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CHAPTER 6 

Description of String Operators 


6.1 WHAT ARE STRINGS? 

A String is a character or a bunch of characters that are stored in memory. Usually, the characters stored 
in a string make up a word or a sentence. Strings are handy because they allow the programmer to deal 
with words instead of numbers. This is useful because it allows one to write “friendly” programs, where 
individuals can be referred to by their names instead of a number. 

MCS BASIC-52 contains ONE dimensioned string variable, $([expr]). The dimension of the string variable 
(the [expr] value) ranges from 0 to 254. This means that 255 different strings can be defined and manipulated 
in MCS BASIC-52. Initially, NO memory is allocated for strings. Memory is allocated by the STRING 
[expr], [expr] STATEMENT. The details of this statement are covered in the DESCRIPTION OF STATE¬ 
MENTS chapter of this manual. 

In MCS BASIC-52, strings can be defined in two ways, with the LET STATEMENT and with the INPUT 
STATEMENT. 

EXAMPLE: 


:>10 STRING lOOiaO 

:>20 $(1) = "THIS IS A STRING, " 

>30 INPUT "WHAT'S YOUR NAME? - ",^(2) 
>40 PRINT $(1),^(2) 

>RUN 

WHAT'S YOUR NAME? - FRED 
THIS IS A STRING, FRED 


STRINGS can also be assigned to each other with a LET statement. 

EXAMPLE: 


♦( 2 )*^< 1 > 


Would assign the STRING value in $(1) to the STRING $(2). 
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6.2 THE ASC OPERATOR 

In MCS BASIC-52, two operators manipulate STRINGS. These operators are ASC( ) and CHR( ). Ad¬ 
mittedly, the string operators contained in MCS BASIC-52 are not quite as powerful as the string operators 
contained in some BASICS. But surprisingly enough, by using the string operators available in MCS 
BASIC-52 it is possible to manipulate strings in almost any way imaginable. This in itself is a commendable 
feat since MCS BASIC-52 was designed primarily to be a sophisticated BASIC language oriented controller, 
not a string manipulator. The string operators available in MCS BASIC-52 are as follows: 

ASC( ) 

The ASC( ) operator returns the integer value of the ASCII character placed in the parentheses. 

EXAMPLE: 


>PRINT ASC<A) 
65 


65 is the decimal representation for the ASCII character “A.” In addition, individual characters in a pre¬ 
defined ASCII string can be evaluated with the ASC() operator. 

EXAMPLE: 


:>10 ♦<l)»"THIS IS A STRING" 
>20 PRINT $<1) 

>30 PRINT ASC(»(l)i1) 

>RUN 

THIS IS A STRING 
84 


When the ASC( ) operator is used in the manner shown above, the $([expr]) denotes what string is being 
accessed and the expression after the comma “picks out” an individual character in the string. In the above 
example, the first character in the string was picked out and 84 is the decimal representation for the ASCII 
character “T.” 
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6.2 THE ASC OPERATOR 

EXAMPLE: 


>10 *< 1 )«‘'ABCDEFOHIJKL" 

>20 FOR X=1 TO 12 
>30 PRINT ASC(S<l)iX), 

>40 NEXT X 
>RUN 

65 66 67 68 69 70 71 72 73 74 75 76 


The numbers printed in the previous example are the values that represent the ASCII characters A,B»C, 
. . . L. 


Additionally, the ASC( ) operator can be used to change individual characters in a defined string. 

EXAMPLE: 


>10 *( 1 )=»“ABCDEFGHIJKL" 

>20 PRINT $(1) 

>30 ASC(IK 1). 1)=75 
>40 PRINT $(1) 

>50 ASC(^(12)«ASC(^<1)i 3) 
>60 PRINT S(l) 

>RUN 

ABCDEFGHIJKL 

KBCDEFGHIJKL 

KCCDEFGHIJKL 


In general, the ASC( ) operator lets the programmer manipulate individual characters in a string. A simple 
program can determine if two strings are identical. 


EXAMPLE: 


>10 $(1)="SECRET" ; REM SECRET IS THE PASSWORD 
>20 INPUT "WHAT'S THE PASSWORD - ",$(2) 

>30 FOR 1=1 TO 6 

>40 IF ASC(»(1),I)=ASC($(2),I) THEN NEXT I ELSE 70 
>50 PRINT "YOU GUESSED IT!" 

>60 END 

>70 PRINT "WRONG, TRY AGAIN" ; GOTO 20 
>RUN 

WHAT'S THE PASSWORD - SECURE 
WRONG, TRY AGAIN 
WHAT'S THE PASSWORD - SECRET 
YOU GUESSED IT 
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6.3 THE CHR OPERATOR 

CHR( ) 


The CHR( ) operator is the converse of the ASC( ) operator. It converts a numeric expression to an ASCII 
character. 

EXAMPLE; 


:»PRINT CHR (65) 
A 


Like the ASC( ) operator, the CHR( ) operator can also “pick out” individual characters in a defined 
ASCII string. 

EXAMPLE: 


MO ♦<1)»“MCS BASIC-52" 

>20 FOR 1*1 TO 12 : PRINT CHR(»(l)iI)i : NEXT I 
:»30 PRINT : FOR 1*12 TO 1 STEP -1 
>40 PRINT CHR(^<l),I)i : NEXT I 
>RUN 

fiCS BASIC-52 
25-CISAB SCM 


In the above example, the expressions contained within the parentheses, following the CHR operator have 
the same meaning as the expressions in the ASC( ) operator. 

Unlike the ASC( ) operator, the CHR( ) operator CANNOT be assigned a value. A statement such as 
CHR($(1),I) = H, is INVALID and will generate a BAD SYNTAX ERROR. Use the ASC( ) operator 
to change a value in a string. The CHR( ) operator can only be used within a print statement! 
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CHAPTER 7 
Special Operators 


7.1 SPECIAL FUNCTION OPERATORS 

SPECIAL FUNCTION OPERATORS are called SPECIAL FUNCTION OPERATORS because they di- 
rectly manipulate the I/O hardware and the memory addresses on the 8052AH device. All SPECIAL 
FUNCTION OPERATORS, with the exception of CBY([expr]) and GET, can be placed on either side of 
the replacement operator (= ) in a LET STATEMENT. 

EXAMPLES: 


A = DBY(IOO) and DBY(IOO) = A*f2 


Both of the above are valid statements in MCS BASIC-52. The SPECIAL FUNCTION OPERATORS in 
MCS BASIC-52 include the following: 

CBY([expr]) 

The CBY([expr]) operator is used to retrieve data from the PROGRAM or CODE MEMORY address space 
of the 8052AH. Since CODE memory cannot be written into on the 8052AH, the CBY([expr]) operator 
cannot be assigned a value. It can only be read. 

EXAMPLE: A = CBY(IOOO) Causes the value in code memory space 1000 to be assigned to the variable 
A. The argument for the CBY([expr]) operator MUST be a valid integer (i.e. between 0 and 65535 
(OFFFFH) ). If it is not, a BAD ARGUMENT ERROR will occur. 

DBY([expr]) 

The DBY([expr]) operator is used to retrieve or assign a value to the 8052AH’s internal data memory. 
Both the value and argument in the DBY operator must be between 0 and 255 inclusive. This is because 
there are only 256 internal memory locations in the 8052AH and one byte can only represent a quantity 
between 0 and 255 inclusive. 

EXAMPLES: 


A=DBY(B) and DBY(250) = CBY(IOOO) 


The first example would assign variable A the value that is in internal memory location B. B would have 
to be between 0 and 255. The second example would load internal memory location 250 with the same 
value that is in program memory location 1000. 
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7.1 SPECIAL FUNCTION OPERATORS 

XBY([expr]) 


The XBY([expr]) operator is used to retrieve or assign a value to the 8052AH’s external data memory. 
The argument in the XBY([expr]) operator must be a valid integer (i.e. between 0 and 65535 (OFFFFH) ). 
The value assigned to the XBY([expr]) operator must be between 0 and 255. If it is not a BAD ARGUMENT 
ERROR will occur. 

EXAMPLES: 


XBY(4000H)»DQY(100) and A^XBY<OFOOOH) 


The first example would load external memory location 4000H with the same value that was in internal 
memory location 100. The second example would make the variable A equal to the value in external 
memory location OFOOOH. 

GET 


The GET operator only produces a meaningful result when used in the RUN mode. It will always return 
a result of zero in the command mode. What GET does is read the console input device. Actually, it takes 
a “snapshot” of the console input device. If a character is available from the console device, the value 
of the character will be assigned to GET. After GET is read in the program, GET will be assigned the 
value of zero until another character is sent from the console device. The following example will print the 
decimal representation of any character sent from the console: 

EXAMPLE: 


MO 

AaOET 



:> 2 o 

IF AOO THEN 

PRINT A 

>30 

GOTO 10 



:>RUN 



65 

(TYPE 

”A” 

ON CONSOLE) 

49 

(TYPE 

M ^ II 

ON CONSOLE) 

24 

(TYPE 

•’CONTROL-X'‘ ON CONSOLE) 

50 

(TYPE 

'*2" 

ON CONSOLE) 


The reason the GET operator can be read only once before it is assigned a value of zero is that this 
implementation guarantees that the first character entered will always be read, independent of where the 
GET operator is placed in the program. 
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7.1 SPECIAL FUNCTION OPERATORS 

The following operators directly manipulate the 8052AH’s special function registers. Specific detail o^ 
the operation of these registers is in the MICROCONTROLLER USERS HANDBOOK, available from 
INTEL. 

IE 

The IE operator is used to retrieve or assign a value to the 8052AH’s special function register IE. Since 
the IE register on the 8052AH is a BYTE register, the value assigned to IE must be between 0 and 255. 
The IE register on the 8052AH contains an unused bit, BIT IE.6. Since this bit is “undefined,” it may 
be read as a random one or zero, so the user may want to mask this bit when reading the IE register. This 
can be done with a statement like A = IE.AND.OBFH. The only statements in MCS BASIC-52 that write 
to the IE register are the CLOCKO, CLOCK 1, ONEX 1, CLEAR, and CLEARI statements. 

EXAMPLES: 


IE = 81H and A * IE. AND. OBFH 


IP 

The IP operator is used to retrieve or assign a value to the 8052AH’s special function register IP. Since 
the IP register on the 8052AH is a BYTE register, the value assigned to IP must be between 0 and 255. 
The IP register on the 8052AH contains two unused bits, BIT IP.6 and IP.7. Since these bits are “un¬ 
defined,” they may be read as a random I or 0, so the user may want to mask these bits when reading 
the IP register. This can be done with a statement such as B = IP.AND.3FH. MCS BASIC-52 does not 
write to the IP register during initialization, so user can establish whatever interrupt priorities are required 
in a given application. 

EXAMPLES: 


IP = 3 and A = IP. AND. 3FH 


PORT1 

The PORTl operator is used to retrieve or assign a value to the 8052AH’s PI I/O port. Since PI on the 
8052AH is a BYTE wide register, the value assigned to PI must be between 0 and 255 inclusive. Certain 
bits on PI have pre-defined functions. If the user does not implement any of the hardware associated with 
these pre-defined functions. The PORTl instruction can be used in any manner appropriate in the application. 
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7.1 SPECIAL FUNCTION OPERATORS 

PCON 

The PCON operator is used to retrieve or assign a value to the 8052AH’s PCON register. In the 8052AH, 
only the most significant bit of the PCON register is used, all other bits are undefined. Setting this bit will 
double the baud rate if TIMER/COUNTER 1 is used as the baud rate generator for the serial port. PCON 
is a byte register. 

RCAP2 

The RCAP2 operator is used to retrieve and/or assign a value to the 8052AH’s special function registers 
RCAP2H and RCAP2L. This operator treats RCAP2H and RCAP2L as a 16-bit register pair. RCAP2H is 
the high byte and RCAP2L is the low byte. The RCAP2H and RCAP2L registers are the reload/capture 
registers for TIMER2. The user must use caution when writing to RCAP2 register because RCAP2 controls 
the BAUD rate of the serial port on the MCS BASIC-52 device. The following can be used to determine 
what BAUD rate the MCS BASIC-52 device is operating at: 

BAUD = XTAL/(32*(65536-RCAP2) ) 

T2CON 

The T2CON operator is used to retrieve and/or assign a value to the 8052AH’s special function register 
T2CON. The T2CON is a byte register that controls TIMER2’s mode of operation and determines which 
timer (TIMER 1 or TIMER2) is used as the 8052AH’s baud rate generator. MCS BASIC-52 initializes 
T2CON with the value 52 (34H) and assumes that its value is never changed. Randomly changing the 
value of T2CON, without knowing what you are doing can “crash” the serial port on the 8052AH. Beware! 
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7.1 SPECIAL FUNCTION OPERATORS 

ICON 

The TCON operator is used to retrieve and/or assign value to the 8052AH’s special function register TCON. 
TCON is a byte register that is used to enable or disable TIMERO and TIMERl, plus the interrupts that 
are associated with these timers. Additionally, TCON determines whether the external interrupt pins on 
the 8052AH are operating in a level sensitive or edge-triggered mode. MCS BASIC-52 initializes TCON 
with the value 244 (0F4H) and assumes that it is never changed. The value 244 (0F4H) places both TIMERO 
and TIMERl in the run (enabled) mode. If the user disables the operation of TIMERO, by clearing BIT 
4 in the TCON register, the REAL TIME CLOCK will NOT work. If the user disables the operation of 
TIMERl, by clearing BIT 6 in the TCON register, the EPROM programming routines, the software serial 
port, and the PWM statement will NOT work. Use caution when changing TCON!!! 

TMOD 

The TMOD operator is used to retrieve and/or assign a value to the 8052AH’s special function register 
TMOD. TMOD is a byte register that controls TIMERO and TIMERl’s mode of operation. MCS BASIC-52 
initializes the TCON register with a value of 16 (lOH). The value 16 (lOH) places TIMERO in mode 0, which 
is a 13-bit counter mode and TIMERl in mode 1, which is a 16-bit counter mode. MCS BASIC-52 
assumes that the modes of these two timer/counters are never changed. If the user changes the mode of 
TIMERO, the REAL TIME CLOCK will not operate properly. If the user changes the mode of TIMERl, 
EPROM programming, the software serial port, and the PWM statement will not work properly. If the 
user does not use these features available in MCS BASIC-52, either timer/counter can be placed in any 
mode required by the specific application. 
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7.1 SPECIAL FUNCTION OPERATORS 

TIME 

The TIME operator is used to retrieve and/or assign a value to the REAL TIME CLOCK resident in MCS 
BASIC-52. After reset, TIME is equal to 0. The CLOCKl statement enables the REAL TIME CLOCK. 
When the REAL TIME CLOCK is enabled, the SPECIAL FUNCTION OPERATOR, TIME will increment 
once every 5 milliseconds. The TIME operator uses TIMERO and the interrupts associated with TIMERO 
on the 8052AH. The unit of TIME is seconds and the appropriate XTAL value must be assigned to insure 
that the TIME operator is accurate. 

When TIME is assigned a value with a LET statement (i.e. TIME = 100), only the integer portion of 
TIME will be changed. 

EXAMPLE: 


>CLOCKl 

(enable REAL TIME CLOCK) 

>CLQCKO 

(disable REAL TIME CLOCK) 

>PRINT TIME 
3. 315 

(display TIME) 

>TIME » 0 

(set TIME a 0) 

:»PRINT TIME 
. 315 

(display TIME) 

(only the integer is changed) 

Tht "fraction" portion of TIME can be changed by 
manipulating the contents of internal memory 
location 71 (47H). This is accomplished by a 0BY(71) 
statement. Note that each count in internal memory 
location 71 (47H) represents 5 milliseconds of TIME. 

Continuing with the EXAMPLE; 

:>DBY(71) ■ 0 

(fraction of TIME » 0) 

:»PRINT TIME 

0 


>DBY<71) « 3 

(fraction of TIME * 3, 15 ms) 

:»PRINT TIME 

1. 5 E-2 
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7.1 SPECIAL FUNCTION OPERATORS 

The reason only the integer portion of TIME is changed when assigned a value is that it allows the user 
to generate accurate time intervals. For instance, let’s say you want to create an accurate 12 hour clock. 
There are 43200 seconds in a 12 hour period, so an ONTIME 43200,[ln num] statement is used. Now, 
when the TIME interrupt occurs the statement TIME = 0 is executed, but the millisecond counter is not 
re-assigned a value so if interrupt latency happens to exceed 5 milliseconds, the clock will still remain 
accurate. 

TIMERO 

The TIMERO operator is used to retrieve or assign a value to the 8052AH’s special function registers THO 
and TLO. This operator treats the byte registers THO and TLO as a 16-bit register pair. THO is the high 
byte and TLO is the low byte. MCS BASIC-52 uses THO and TLO to implement the REAL TIME CLOCK 
function. If the user does not implement the REAL TIME CLOCK function (i.e. does not use the statement 
CLOCK 1) in the BASIC program THO and TLO may be used in any manner suitable to the particular 
application. 

TIMER1 


The TIMERl operator is used to retrieve or assign a value to the 8052AH’s special function registers THl 
and TLl. This operator treats the byte registers THl and TLl as a 16-bit register pair. THl is the high 
byte and TLl is the low byte. MCS BASIC-52 uses THl and TLl to implement the timings for the software 
serial port, the EPROM programming feature, and the PWM statement. If the user does not use any of 
these features THl and TLl may be used in any manner suitable to the particular application. 

TIMER2 

The TIMER2 operator is used to retrieve or assign a value to the 8052AH’s special function registers TH2 
and TL2. This operator treats the byte registers TH2 and TL2 as a 16-bit register pair. TH2 is the high 
byte and TL2 is the low byte. MCS BASIC-52 uses TH2 and TL2 to generate the baud rate for the serial 
port. If the user does not use TIMER2 to clock the serial port, TH2 and TL2 may be used in any manner 
suitable to the particular application. 
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7.1 SPECIAL FUNCTION OPERATORS 

XTAL 

The XTAL operator tells MCS BASIC-52 what frequency the system is operating at. The XTAL operator 
is used by MCS BASIC-52 to calculate the REAL TIME CLOCK reload value, the PROM programming 
timing, and the software serial port baud rate generation. The XTAL value is expressed in Hz. So, 

XTAL = 9000000 

would set the XTAL value to 9 MHz. 
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7.2 EXAMPLES OF MANIPULATING SPECIAL FUNCTION VALUES 

Using the logical operators available in MCS BASIC-52, it is possible to write to or read from any byte 
of the special function registers that MCS BASIC-52 treats as a register pair: 

EXAMPLE: 

WRITING TO THE HIGH BYTE 

>TIMER6 = (TIMERO .AND. OOFFH)+ INT(256*(USER BYTE)) 

EXAMPLE: 


WRITING TO THE LOW BYTE 

:»TIMERO = (TIMERO .AND. OFFOOH) + (USER BYTE) 


EXAMPLE: 


READING HIGH BYTE 
:»PHO. INT(TIMER0/256) 


EXAMPLE: 


READING LOW BYTE 
:>PHO. TIMERO . AND. OFFH 


TIMERl can function as the baud rate generator for MCS BASIC-52. To assign TIMERl as the baud rate 
generator, the following instructions must be executed: 


>TMdD * 32 - TIMERl in auto reload mode 

:>TIMER1 = 256*(256-<65536-RCAP2>/12) - load TIMERl 
>T2C0N =0 - .use TIMERl as baud rate gen 


This sequence of instructions can be executed in either the direct mode or as part of a program. When 
TIMERl is used as the baud rate generator, TIMER2 can be used in anyway suitable to the application. 
The PROG, FPROG, LIST#, PRINT# and PWM commands/statements cannot be used when TIMERl 
functions as the baud rate generator for the MCS BASIC-52 device. Certain crystals may not be able to 
use TIMERl as the baud rate generator, especially at high (above 2400) baud rates. 
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7.3 SYSTEM CONTROL VALUES 

The SYSTEM CONTROL VALUES determine or reveal how memory is allocated by MCS BASIC-52. 

MTOP 

After reset, MCS BASIC-52 sizes the external memory and assigns the last valid memory address to the 
SYSTEM CONTROL VALUE, MTOP. MCS BASIC-52 will not use any external RAM memory beyond 
the value assigned to MTOP. If the user wishes to allocate some external memory for an assembly language 
routine the LET statement can be used (e.g. MTOP = USER ADDRESS). If the user assigns a value to 
MTOP that is greater than the last valid memory address, a MEMORY ALLOCATION ERROR will be 
generated. 

EXAMPLES: 


:»PRINT MTOP 
2047 

>MT0P*2000 

>PRINT MTOP 
2000 


LEN 

The SYSTEM CONTROL VALUE, LEN, tells the user how many bytes of memory the current selected 
program occupies. Obviously, LEN cannot be assigned a value, it can only be read. A NULL program 
(i.e. no program) will return a LEN of 1. The 1 represents the end of program file character. 

FREE 

The SYSTEM CONTROL VALUE, FREE, tells the user how many bytes of RAM memory are available 
to the user. When the current selected is in RAM memory, the following relationship will always hold 
true. 

FREE = MTOP - LEN - 511 

NOTE: Unlike some BASICS, MCS BASIC-52 does not require any ‘ ‘dummy’ ’ arguments for the SYSTEM 
CONTROL VALUES. 
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CHAPTERS 

Error Messages, Bells, Whistles, and Anomalies 


8.1 ERROR MESSAGES 

MCS BASIC-52 has a relatively sophisticated ERROR processor. When BASIC is in the RUN mode the 
generalized form of the ERROR message is as follows: 


ERROR: XXX ~ IN LINE YYY 

YYY BASIC STATEMENT 
-X 


Where XXX is the ERROR TYPE and YYY is the line number of the program in which the error occurred. 
A specific example is: 


ERROR. BAD SYNTAX *- IN LINE 10 

10 PRINT 34*21* 

-X 


The X signifies approximately where the ERROR occurred in the line number. The specific location of 
the X may be off by one or two characters or expressions depending on the type of error and where the 
error occurred in the program. If an ERROR occurs in the COMMAND MODE only the ERROR TYPE 
will be printed out NOT the Line number. This makes sense, because there are no line numbers in the 
COMMAND MODE. The ERROR TYPES are as follows: 

BAD SYNTAX 

A BAD SYNTAX error means that either an invalid MCS BASIC-52 COMMAND, STATEMENT, or 
OPERATOR was entered and BASIC cannot process the entry. The user should check and make sure that 
everything was typed in correctly. In Version 1.1 of MCS BASIC-52 a BAD SYNTAX ERROR is also 
generated if the programmer attempts to use a reserved keyword as part of a variable. 

BAD ARGUMENT 

When the argument of an operator is not within the limits of the operator a BAD ARGUMENT ERROR 
will be generated. For instance, DBY(257) would generate a BAD ARGUMENT ERROR because the 
argument for the DBY operator is limited to the range 0 to 255. Similarly, XBY(5000H) = -1 would 
generate a BAD ARGUMENT ERROR because the value of the XBY operator is limited to the range 0 
to 255. 
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8.1 ERROR MESSAGES 

ARITH. UNDERFLOW 

If the result of an arithmetic operation exceeds the lower limit of an MCS BASIC-52 floating point number, 
an ARITH. UNDERFLOW ERROR will occur. The smallest floating point number in MCS BASIC-52 is 
± IE -127. For instance, 1E-80/1E + 80 would cause an ARITH. UNDERFLOW ERROR. 

ARITH. OVERFLOW 

If the result of an arithmetic operation exceeds the upper limit of an MCS BASIC-52 floating point number, 
an ARITH. OVERFLOW ERROR will occur. The largest floating point number in MCS BASIC-52 is 
± .99999999E+ 127. For instance, lE + 70*lE-f 70 would cause an ARITH. OVERFLOW ERROR. 

DIVIDE BY ZERO 

A division by ZERO was attempted i.e. 12/0, will cause a DIVIDE BY ZERO ERROR. 

ILLEGAL DIRECT (VERSION 1.0 ONLY) 

Some statements, such as IF-THEN and DATA cannot be executed while the MCS BASIC-52 device is 
in the COMMAND MODE. If you attempt to execute one of these statements the message ERROR: 
ILLEGAL DIRECT will be printed to the console device. The ILLEGAL DIRECT ERROR is not trapped 
in Version 1.1 of MCS BASIC-52. ILLEGAL DIRECT ERRORS return a BAD SYNTAX ERROR in 
Version 1.1. 

LINE TOO LONG (VERSION 1.0 ONLY) 

If you type in a line that contains more than 73 characters the message ERROR: LINE TOO LONG will 
be printed to the console device. MCS BASIC-52’s input buffer can only handle up to 73 characters. 

NOTE 

This error does not exist in Version 1.1. Instead the input buffer has been increased to 79 characters and 
MCS BASIC-52 will echo a bell character to the user terminal if too many characters are entered into the 
input buffer. 

NO DATA 

If a READ STATEMENT is executed and no DATA STATEMENT exists or all DATA has been read 
and a RESTORE instruction was hot executed the message ERROR: NO DATA — IN LINE XXX will 
be printed to the console device. 
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8.1 ERROR MESSAGES 

CANT CONTINUE 

Program execution can be halted by either typing in a control-C to the console device or by executing a 
STOP STATEMENT. Normally, program execution can be resumed by typing in the GONT command. 
However, if the user edits the program after halting execution and then enters the CONT command, a 
CANT CONTINUE ERROR will be generated. A control-C must be typed during program execution or 
a STOP STATEMENT must be executed before the CONT command will work. 

PROGRAMMING 

If an error occurs while the MCS BASIC-52 device is programming an EPROM, a PROGRAMMING 
ERROR will be generated. An error encountered during programming destroys the EPROM FILE STRUC¬ 
TURE, so the user cannot save any more programs on that particular EPROM once a PROGRAMMING 
ERROR occurs. 

A-STACK 

An A-STACK (ARGUMENT STACK) error occurs when the argument stack pointer is forced “out of 
bounds.” This can happen if the user overflows the argument stack by PUSHing too many expressions 
onto the stack, or by attempting to POP data off the stack when no data is present. 

C-STACK 

A C-STACK (CONTROL STACK) error will occur if the control stack pointer is forced “out of bounds.” 
158 bytes of external memory are allocated for the control stack, FOR — NEXT loops require 17 bytes 
of control stack DO — UNTIL, DO — WHILE, and GOSUB require 3 bytes of control stack. This means 
that 9 nested FOR — NEXT loops is the maximum that MCS BASIC-52 can handle because 9 times 17 
equals 153. If the user attempts to use more control stack than is available in MCS BASIC-52 a C-STACK 
error will be generated. In addition, C-STACK errors will occur if a RETURN is executed before a GOSUB, 
a WHILE or UNTIL before a DO, or a NEXT before a FOR. 
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8.1 ERROR MESSAGES 

l-STACK 

An I-STACK (INTERNAL STACK) error occurs when MCS BASIC-52 does not have enough stack space 
to evaluate an expression. Normally, I-STACK errors will not occur unless insufficient memory has been 
allocated to the 8052AH’s stack pointer. Details of how to allocate memory to the stack pointer are covered 
in the ASSEMBLY LANGUAGE LINKAGE section of this manual. 

ARRAY SIZE 

If an array is dimensioned by a DIM statement and then you attempt to access a variable that is outside 
of the dimensioned bounds, an ARRAY SIZE error will be generated. 

EXAMPLE: 


:»DIM A(10) 

:»PRINT A(ll) 

ERROR: ARRAY SIZE 
READY 


MEMORY ALLOCATION 


MEMORY ALLOCATION ERRORS are generated when user attempts to access STRINGS that are 
“outside” the defined string limits. Additionally, if the SYSTEM CONTROL VALUE, MTOP is assigned 
a value that does not contain any RAM memory, a MEMORY ALLOCATION ERROR will occur. 


99 








MCS^BASiC-52 


8.2 DISABLING CONTROL-C 

In some applications, it may be desirable or even a requirement that program execution not accidentally 
be halted. Under “normal” operation the execution of any MCS BASIC-52 program can be terminated 
by typing a “control-C” on the console device. However, it is possible to disable the “control-C” break 
function in MCS BASIC-52. This is accomplished by setting BIT 48 (30H) to a one. BIT 48 is located in 
internal memory location 38.0 (26.OH). This BIT may be set by executing the following statement in an 
MCS BASIC-52 program: 

DBY(38) = DBY(38).OR.01H 

Once this BIT is set to a one, the control-C break function, for both LIST and RUN operations will be 
disabled. The user has the option to create a custom break character or string of characters by using the 
GET operator. The following is an example of how to implement a custom break character: 

EXAMPLE: 


>10 STRING lOOi10: A*!: REM INITIALIZE STRINGS 
>20 ♦<!) « "BREAK'* : REM "BREAK'* IS THE PASSWORD 
>30 DBY(38>»DBY<38).OR. 1 : REM DISABLE CONTROL-C 
>40 FOR lal TO 1000 : REM DUMMY LOOP 
>50 J*SIN<I) 

>60 K=GET : IF KOO THEN 100 ELSE NEXT I 
>70 END 

>100 IF KaASC<S< 1A) THEN A«A->-l ELSE A»1 

>110 REM TEST FOR MATCH 

>120 IF A»il THEN NEXT .1 

>130 IF A»6 THEN 200 ELSE NEXT I 

>140 END 

>200 PRINT "BREAK** 

>210 DBY(38)»DBY<3a). AND. OFEH : REM ENABLE CONTROL-C 


In this example, typing the word BREAK will stop program execution. In other words, BREAK is a 
password. 
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8.3 IMPLEMENTING “FAKE DMA” 

The MCS BASIC-52 device does not contain any hardware mechanism that supports Direct Memory Access 
(DMA). However, the DMA function is supported in software by MCS BASIC-52. During DMA operation 
MCS BASIC-52 guarantees that no external memory access will be performed. To enable the DMA function, 
the following must be performed: 

1) BIT 49, which is located in internal memory location 38.1 (26. IH) must be set to a one. This can be 
accomplished in BASIC by using the statement — DBY(38) = DBY(38).OR.02H 

2) BIT 0 and BIT 7 of the SPECIAL FUNCTION REGISTER, IE (Interrupt enable) must be set to a one. 
This can be accomplished in BASIC by using the statement — IE = IE.OR.81H 


After the three BITS mentioned above are set to a one, external interrupt zero (INTO) acts as a DMA input 
pin. INTO is pin 12 on the 8052AH. Whenever INTO is pulled low (to a logical zero state), the MCS 
BASIC-52 device will enter the DMA mode and no accesses will be made to external memory. To 
acknowledge that MCS BASIC-52 has entered the DMA mode, MCS BASIC-52 outputs a zero on pin 7 
(PI.6). In essence, PORT 1.6 is the DMA ACK pin of the MCS BASIC-52 device. In most applications, 
this pin would be used to disable three-state buffers that would be placed on PORT2, PORTO, and the 
address latch of the MCS BASIC-52 system. After the user pulls the INTO pin high, MCS BASIC-52 will 
output a one on PI.6 and normal program execution will con tinue. During this “fake DMA” cycle, the 
MCS BASIC-52 program does nothing except wait for the INTO pin to be pulled high. So, program 
execution is halted. 

It should be noted that although this “fake DMA” operation does provide the same functionality as a 
normal DMA hardware mechanism, it also takes substantially longer for the normal DMA REQUEST — 
DMA ACKNOWLEDGE cycle to be performed. That is because MCS BASIC-52 uses interrupts to 
implement the DMA operation, instead of dedicated hardware. As a general rule, cycle stealing DMA is 
not an option with MCS BASIC-52’s “fake” DMA. Only “burst mode” DMA cycles can be implemented 
without a significant time penalty. When “fake DMA” is implemented, the user must provide three-state 
buffers on the PORT2, PORTO, and the address latch of the MCS BASIC-52 system. 
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8.4 RUN TRAP OPTION (Version 1.1 Only) 

Version 1.1 of MCS BASIC-52 permits the user to trap the interpreter in the RUN MODE. This option 
is evoked by putting a 34H (52D) in external data memory location 5EH (94D). After a 34H (52D) is 
placed in external data memory location 5EH (94D) the MCS BASIC-52 interpreter will be trapped in the 
RUN mode forever or until the contents of external data memory location is changed to something other 
than 34H (52D). If no program is present when a 34H (52D) is placed in location 5EH (94D), MCS 
BASIC-52 will print the READY message forever and it will be time to RESET the device. The RUN 
TRAP option can be employed with the other RESET options to permit the user to execute a program from 
RAM on a RESET or power-up condition when some type of battery back-up memory scheme is employed. 
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8.5 ANOMALIES 

Most dictionaries define an anomaly as a deviation from the normal or common order or as an irregularity. 
Anomalies to an extreme become “BUGS” or something that is wrong with the program. Like all programs, 
MCS BASIC-52 contains some anomalies, hopefully, no bugs. The purpose of mentioning the known 
anomalies here is that it may save the programmer some time, should strange things happen during program 
execution. The known anomalies deal mainly with the way MCS BASIC-52 compacts or tokenizes the 
BASIC program. The known anomalies and cautions are as follows: 

1) When using the variable H after a line number, make sure you put a space between the line number 
and the H, or else BASIC will assume that the line number is a HEX number. 

EXAMPLES: 


:>20H*10 (WRONG) 

:>20 H=10 (RIGHT) 

:>LIST 

>LIST 

32 «10 

o 

II 

I 

o 

ru 


2) When using the variable I before an ELSE statement, make sure you put a space between the I and the 
ELSE statement, or else BASIC will assume that the IE portion of lELSE is the special function operator 
IE. 

EXAMPLES: 


:»20 IF I>10 THEN PRINT lELSE 100 
:>LIST 

20 IF IMO THEN PRINT lELSE 100 (WRONG) 


:>20 IF IMO THEN PRINT I ELSE 100 
>LIST 

20 IF IMO THEN PRINT I ELSE 100 (RIGHT) 


3) A Space character may not be placed inside the ASC( ) operator. In other words, a statement like 
PRINT ASC( ) will yield a BAD SYNTAX ERROR. Spaces may be placed in strings however, so 
a statement like LET $(1) = “HELLO, HOW ARE YOU” will work properly. The reason ASC( ) 
yields an error is because MCS BASIC-52 eliminates all spaces when a line is processed, so ASC( ) 
will be stored as ASC( ) and MCS BASIC-52 interprets this as an error. 
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CHAPTER 9 

Assembly Language Linkage 


9.1 OVERVIEW 

NOTE: This section assumes that the designer has an understanding of the architecture and assembly 
language of the MCS-51 Microcontroller family!!! 

MGS BASIC-52 contains a complete library of routines that can easily be accessed with assembly language 
CALL instructipns. The advantage of using assembly language is that it offers a significant improvement 
in execution speed relative to interpreted BASIC. In order to successfully interface MCS BASIC-52 with 
an assembly language program, the software designer must be aware of a few simple facts. 

READ THIS CAREFULLY!!! 

1. MCS BASIC-52 uses REGISTER BANKS 0, 1, and 2 (RBO, RBI, and RB2). REGISTER BANK 3 
(RB3) is never used except during a PGM statement. RB3 is designated the USER REGISTER BANK 
and the users can do whatever they want to with REGISTER BANK 3 (RB3) and MCS BASIC-52 will 
never alter the contents of this REGISTER BANK except during the execution of a PGM statement. 
The contents of REGISTER BANK 3 (RB3) can be changed by executing a DBY ([expr]) == [0 to 255] 
statement. Where the [expr] evaluates to a number between 24 (18H) and 31 (IFH) inclusive. In 
addition, INTERNAL MEMORY LOCATIONS 32 (20H) and 33 (21H) are also NEVER used by MCS 
BASIC-52. These two BIT and/or BYTE addressable locations are specifically reserved for assembly 
language programs. 

2. MCS BASIC-52 uses REGISTER BANK 0 (RBO) as the WORKING REGISTER FILE. Whenever 
assembly language is used to access MCS BASIC-52’s routines, the WORKING REGISTER FILE, 
REGISTER BANK 0 (RBO) MUST BE SELECTED!!! This means that the USER MUST MAKE: SURE 
THAT REGISTER BANK 0 (RBO) IS SELECTED BEFORE CALLING ANY OF MCS BASIC-52’s 
ROUTINES. This is done simply by setting BITS 3 and 4 in the PSW equal to ZERO. If this is not 
done, MCS BASIC-52 will “KICK OUT” the USER and NO operation will be performed. When an 
ASSEMBLY LANGUAGE program is accessed by using the MCS BASIC-52’s CALL instruction, 
REGISTER BANK 0 (RBO) will always be selected. So unless the user selects REGISTER BANK 3 
(RB3) in assembly language, it is NOT NECESSARY to change the designated REGISTER BANK. 

3. ALWAYS ASSUME THAT MCS BASIC-52 DESTROYS THE CONTENTS OF THE WORKING 

REGISTER FILE AND THE DPTR, UNLESS OTHERWISE STATED IN FOLLOWING DOCU¬ 
MENTATION. a 

4. Certain routines in MCS BASIC-52 require that REGISTERS be initialized BEFORE the user CALLS 
that specific ROUTINE. These registers are ALWAYS in the WORKING REGISTER FILE, REGISTER 
BANK 0 (RBO). 

5. Certain routines in MCS BASIC-52 return the result of an operation in a register or registers. The result 
registers are ALWAYS in the WORKING REGISTER FILE, REGISTER BANK 0, (RBO). 
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9.1 OVERVIEW 

READ THIS CAREFULLY!!! 

6. MCS BASIC-52 loads the INTERNAL STACK POINTER (SPECIAL FUNCTION REGISTER- SP) 
with the value that is in INTERNAL MEMORY LOCATION 62 (3EH). MCS BASIC-52 initializes 
INTERNAL MEMORY LOCATION 62 (3EH) by writing a 77 (4DH) to this location after a hardware 
RESET. MCS BASIC-52 does NOT use any memory beyond 77 (4DH) for anything EXCEPT STACK 
SPACE. If the user wants to ALLOCATE some additional internal memory for their application, this 
is done by changing the contents of INTERNAL MEMORY LOCATION 62 (3EH) to a value that is 
GREATER than 77 (4DH). This will allocate the INTERNAL MEMORY LOCATIONS from 77 (4DH) 
to the value that is placed in INTERNAL MEMORY LOCATION 62 (3EH) to the user. As a guideline, 
it is a good idea to allow at least 48 (30H) bytes of stack space for MCS BASIC-52. The bad news 
about reducing the stack space is that it will reduce the amount of nested parentheses that MCS BASIC-52 
can evaluate in an expression [expr]. This will either cause a I-STACK ERROR or will cause a fatal 
CPU “crash.” Use caution and DON’T allocate more memory than you need. 

EXAMPLE OF THE EFFECTS OF ALTERING THE STACK ALLOCATION: 


COMMENTS 


>PRINT DBY(62) AFTER RESET INTERNAL MEMORY LOCATION 62 

77 CONTAINS A 77 


:>PRINT (1*(2*<3>>) BASIC HAS NO PROBLEM EVALUATING 3.LEVELS 

6 OF NESTED PARENTHESIS 


:»DBY(62)»230 
:>PRINT <1*(2*<3))) 


NOW ALLOCATE 255-230 » 25 BYTES OF STACK 
SPACE TO BASIC, REMEMBER, THE STACK ON 
THE 8052AH GROWS '•UP" 


ERROR: I-STACK 
READY 

>DBY(62>*210 

>PRINT (HK2*<3))) 
6 


BASIC CANNOT EVALUATE THIS EXPRESSION 
BECAUSE IT DOES NOT HAVE ENOUGH STACK 
NOW ALLOCATE 255-210 = 45 BYTES OF STACK 
SPACE TO BASIC 
THE I-STACK ERROR GOES AWAY 


7. Throughout this section a 16-BIT REGISTER PAIR is designated-Rx.Ry, where Rx is the most sig¬ 
nificant byte and Ry is the least significant byte. 

EXAMPLE: 


R3:R1 - R3=M0ST SIGNIFICANT BYTE, R1=LEAST SIGNIFICANT BYTE 
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9.2 GENERAL PURPOSE ROUTINES 

Accessing MCS BASIC-52 routines with assembly language is easy. The user just loads the ACCUMU¬ 
LATOR with a specific value and CALLS LOCATION 48 (30H). The value placed in the ACCUMULATOR 
determines what operation will be performed. Unless otherwise stated, the CONTENTS of the DPTR and 
REGISTER BANK 0 (RBO) will ALWAYS be altered when calling these routines. The generalized form 
for accessing MCS BASIC-52’s routines is as follows: 

; make sure 
RBO is 
selected 
; load the 
instruction 
; execute the 
instruction 

The value of OPBYTE determines what operation will be performed. The following operations can be 
performed: 

OPBYTE = 0 (OOH) RETURN TO COMMAND MODE 

This instruction causes MCS BASIC-52 to enter the COMMAND MODE. Control of the CPU is handed 
back to the MCS BASIC-52 interpreter and BASIC will respond by outputting a READY and a PROMPT 
character (>). 

OPBYTE = 1 (01H) POP ARGUMENT STACK AND PUT VALUE IN R3:R1 

This instruction converts the value that is on the ARGUMENT STACK to a 16 BIT BINARY INTEGER 
and returns the BINARY INTEGER in registers R3 (high byte) and R1 (low byte) of REGISTER BANK 
0 (RBO). The ARGUMENT STACK gets popped after this instruction is executed. If the value on the 
ARGUMENT STACK cannot be represented by a 16-BIT BINARY NUMBER (i.e. it is NOT between 0 
and 65535 (OFFFFH) inclusive), BASIC WILL TRAP THE ERROR and print a BAD ARGUMENT 
ERROR MESSAGE. The BINARY VALUE returned is TRUNCATED, NOT ROUNDED. 

EXAMPLE: 


BASIC PROGRAM - 10 PUSH 260 

20 CALL 5000H 

ASSEMBLY LANGUAGE PROGRAM - ORG 5000H 

MOV A«#01H i load opbyte 

CALL 30H i RBO still selected 

i ■ - . I ’ ' ' 

i at this point R3 (of RBO) = OlH 
i arid Rl (of RBO) » 04H 
i sof R3:R1 s 260« uhich uias the value 
; that u^as placed on the ARGUMENT STACK 


ANL PSW,#1110011 IB 

MOV A,#OPBYTE 
CALL 30H 
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9.2 GENERAL PURPOSE ROUTINES 

COMMENTS ON THE NEXT TWO INSTRUCTIONS: 

The next two instructions permit the user to transfer floating point numbers between an assembly language 
program and MCS BASIC-52. The user provides the address where a floating point number is stored or 
will be stored in a 16-bit REGISTER PAIR. Depending on the operation requested, the floating point 
numbers are either PUSHED ON or POPPED OFF MCS BASIC-52’s ARGUMENT STACK. This in¬ 
struction permits the user to keep track of variables in assembly language and bypass the relatively slow 
procedure BASIC must follow. 

As mentioned earlier, when a floating point number is PUSHED onto the ARGUMENT STACK, the 
ARGUMENT STACK POINTER is decremented by a count of 6. This is because a floating point number 
requires 6 bytes of RAM storage. Although it may seem confusing to the novice, the LAST value placed 
on the ARGUMENT STACK is referred to as the value on the TOP of the ARGUMENT STACK, even 
though it is on the BOTTOM of the STACK relative to the sequential numbering of memory addresses. 
No one knows why this is so. 

The ARGUMENT STACK resides in EXTERNAL RAM MEMORY LOCATIONS 301 (12DH) through 
510 (IFEH). The lower BYTE of the ARGUMENT STACK POINTER resides in INTERNAL MEMORY 
LOCATION 9 (09H). MCS BASIC-52 always assumes that the upper BYTE (higher order address) of the 
ARGUMENT STACK POINTER is 1 (OlH). The software designer can use this information, along with 
the next two instructions to perform operations like copying the stack. 

OPBYTE = 2 (02H) PUSH THE FLOATING POINT NUMBER ADDRESSED BY REGISTER 
PAIR R2:R0 ONTO THE ARGUMENT STACK. 

R2 and RO (in REGISTER BANK 0, RBO) contain the ADDRESS (R2 = high byte, RO = low byte) of 
the location where the floating point number is stored. After this instruction is executed the floating point 
number that the REGISTER PAIR R2:R0 points to is PUSHED onto the TOP of the ARGUMENT STACK. 
The ARGUMENT STACK POINTER automatically gets DECREMENTED, by a count of 6, when the 
value is placed on the stack. A floating point number in MCS BASIC-52 requires 6 BYTES of RAM 
storage. The register Pair R2:R0 points to the MOST SIGNIFICANT BYTE of the floating point number 
and is DECREMENTED BY 6 after the CALL instruction is executed. So, if R2:R0 = 7F18H before this 
instruction was executed, it would equal 7F12H after this instruction was executed. 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 3 (OSH) POP THE ARGUMENT STACK AND SAVE THE FLOATING POINT 
NUMBER IN THE LOCATION ADDRESSED BY R3:R1. 

The TOP of the ARGUMENT STACK is moved to the location pointed to by the REGISTER PAIR 
R3:R1(R3 = high byte, R1 = low byte, in REGISTER BANK 0, RBO). The ARGUMENT STACK 
POINTER is automatically INCREMENTED BY 6. Just as in the previous PUSH instruction, the REG¬ 
ISTER PAIR R3:R1 points to the MOST SIGNIFICANT BYTE of the floating point number and is 
DECREMENTED BY 6 after the CALL instruction is executed. 

EXAMPLE OF USER PUSH AND POP: 


BASIC PROGRAM: 

>5 REM PUT 100 AND 200 ON 
>10 PUSH 100i200 

THE ARGUMENT STACK 


>15 REM CALL THE USER ROUTINE TO SAVE NUMBERS 


>20 CALL 5000H 

>25 REM CLEAR THE STACK 

>30 CLEARS 



>35 REM USE ASM TO PUT NUMBERS BACK ON STACK 


>40 CALL 501OH 
>50 POP A,B 
>60 PRINT A. B 
>RUN 

100 200 

READY 


ASM PROGRAM; 

ORG 5000H 



MOV R3i#HIGH USER.SAVE 

LOAD POINTERS TO WHERE 


MOV Rl,#LOW USER^SAVE 

NUMBERS WILL BE SAVED. 


MOV A.#03H 

LOAD OPBYTE 


CALL 30H 

SAVE ONE NUMBER 


MOV Ai#03H 

LOAD OPBYTE AGAIN 


CALL 30H 

SAVE ANOTHER NUMBER 


RET 

i 

ORG 501OH 

BACK TO BASIC 


MOV R2i#HIGH USER.SAVE 

LOAD ADDRESS WHERE 


MOV RO,#LOW USER_SAVE 

NUMBERS ARE STORED 


MOV A,#02H 

LOAD OPBYTE 


CALL 30H 

PUT ONE NUMBER ON STACK 


MOV Ai#02H 

LOAD OPBYTE 


CALL 30H 

NEXT NUMBER ON STACK 


RET 

BACK TO BASIC 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 4 (04H) PROGRAM A PROM USING R3:R1 AS THE SOURCE ADDRESS 
POINTER, R2:R0 AS THE DESTINATION (PROM) ADDRESS POINTER, AND R7:R6 AS THE 
BYTE COUNTER. 

This instruction assumes that the DATA to be programmed into a PROM is stored in external memory 
and that the REGISTER PAIR R3:R1 (in RBO) contains the address of this external memory. REGISTER 
PAIR R7:R6 contains the total number of bytes that are to be programmed. The PROM is programmed 
sequentially and everytime a byte is programmed the REGISTER PAIR R7:R6 is decremented and the 
REGISTER PAIRS R3:R1 and R2:R0 are incremented. Programming continues until R7:R6 equals ZERO. 
The REGISTER PAIR R2:R0 must be initialized with the desired ADDRESS of the EPROM to be 
programmed MINUS 1. This may sound strange, but that is the way it works. So, if you wanted to program 
ah EPROM starting at address 9000H, with the data stored in address ODOOH and you wanted to program 
500 BYTES, then the registers would be set up as follows: R2:R0 = 8FFFH, R3:R1 = ODOOH, and 
R7:R6 = 01F4H (500 decimal). You would then put a 4 (04H) in the ACC and CALL location 30H. 

NOTE: In Version 1.0, if an ERROR OCCURS DURING PROGRAMMING, MCS BASIC-52 WILL 
TRAP THE ERROR AND ENTER THE COMMAND MODE. The user cannot handle errors that occur 
during the EPROM programming operation!!!! 

In Version 1.1, programming errors will only be trapped if the MCS BASIC-52 device is in the COMMAND 
MODE. If the MCS BASIC-52 device is in the run mode, control will be passed back to the user. The 
user must then examine registers R6 and R7. If R6 = R7 = 0, then the programming operation was 
successfully completed, if these registers do not equal zero then registers R2:R0 contain the address of the 
EPROM location that failed to program. This feature in Version 1.1 permits the user to program EPROMS 
in embedded applications and manage errors, should they occur in the programming process, without 
trapping to the command mode. 

In addition to setting up the pointers previously described, the user must also initialize the INTERNAL 
MEMORY locations that control the width of the programming pulse. This gives the user complete control 
over this critical prom programming parameter. The internal memory locations that must be initialized 
with this information are 64 (40H) and 65 (41H). These locations are treated as a 16 bit register pair with 
location 64 (40H) designated as the most significant byte and location 65 (41H) as the least significant 
byte. Locations 64 (40H) and 65 (41H) are loaded into THl (TIMER 1 high byte) and TLl (TIMER 1 
low byte) respectively. The width of the prograniming pulse, in microseconds is determined by the following 
equation: 

WIDTH = (65536 — 256*DBY(64) + DBY(65))*12/XTAL microseconds 
conversely; 

DBY(64):DBY(65) = 65536 — WIDTH*XTAL/12 

The proper values for the “normal” 50 millisecond programming algorithm and the 1 millisecond 
“INTELligent” algorithm are calculated and stored by MCS BASIC-52 in external memory locations 
296:297 (128H:129H) and 298:299 (12AH:12BH) respectively. If the user wants to use the pre-calculated 
values the statements DBY(64) = XBY(296) and DBY(65) = XBY(297) may be used to initialize the prom 
programming width for the normal algorithm and the statements DBY(64) = XBY(298) and 
DBY(65) = XBY(299) can be used to initialize for the INTELligent algorithm. 
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To select the “INTELLIGENT” EPROM PROGRAMMING algorithm the directly addressable BIT 51 
(33H) MUST be set to 1 before the EPROM PROGRAMMING routine is called. The “STANDARD” 
50 ms EPROM PROGRAMMING algorithm is selected by CLEARING BIT 51 (33H) (i.e. BIT 51 = 0) 
before calling the EPROM PROGRAMMING routine. The directly addressable BIT 51 is located in internal 
memory location 38.3 (26 3H) (BIT 3 of BYTE 38 (26H) in internal memory). This BIT can be SET or 
CLEARED by the BASIC STATEMENTS DBY(38) = DBY(38).OR.08H to SET and 
DBY(38) = DBY(38).AND.0F7H to CLEAR, Of course, the user can set or clear this bit in assembly 
language with a SETB 51 or CLR 51 instruction. 

The user must also turn on the EPROM PROGRAMMING voltage BEFORE calling the EPROM PRO¬ 
GRAMMING routine. This is done by CLEARING BIT PI.5, the fifth BIT on PORT 1. This too can be 
done in BASIC with a PORTl = PORTl.AND.ODFH instruction or in assembly language with a CLR PI .5 
instruction. The user must also set this bit when the PROM PROGRAMMING procedure is complete. 

This instruction assumes that the hardware surrounding the MCS BASIC-52 device is the same as the 
suggestions in the EPROM PROGRAMMING chapter of this manual. 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 5 (OSH) INPUT A STRING OF CHARACTERS AND STORE IN THE BASIC 
INPUT BUFFER. 

This instruction inputs a line of text from the console device and saves the information in the MCS BASIC- 
52’s input buffer. MCS BASIC-52’s input buffer begins at EXTERNAL MEMORY LOCATION 7 (0007H). 
All of the line editing features available in MCS BASIC-52 are implemented in this instruction. If a control- 
C is typed during the input process, MCS BASIC-52 will trap back into the command mode. A carriage 
return (cr) terminates the input procedure. 

OPBYTE = 6 (06H) OUTPUT THE STRING OF CHARACTERS POINTED TO BY THE 
REGISTER PAIR R3:R1 TO THE CONSOLE DEVICE. 

This instruction is used to OUTPUT a string of characters to the c#sole device. R3:R1 contains the initial 
address of this string. The string can either be stored in PROGRAM MEMORY or EXTERNAL DATA 
MEMORY. If BIT 52 (34H) (which is BIT 4 of internal RAM location 38 (26H)) is set, the output will 
be from PROGRAM MEMORY. If BIT 52 is cleared, the output will be from EXTERNAL DATA 
MEMORY. The DATA stored in MEMORY is sent out to the console device one byte at a time and the 
memory pointer is incremented. The output is stopped when a termination character is read. The termination 
character for PROGRAM MEMORY and EXTERNAL DATA MEMORY are different. The termination 
character for EXTERNAL DATA MEMORY is a (cr) ODH. The termination character for PROGRAM 
MEMORY is a " or 22H. 

OPBYTE = 7 (07H) OUTPUT A CARRIAGE RETURN-LINE FEED SEQUENCE TO THE 
CONSOLE DEVICE. 

Enough said. 

OPBYTE = 128 (80H) OUTPUT THE CHARACTER IN R5 (REGISTER BANK 0) TO THE 
CONSOLE DEVICE. 


This routine takes the character that is in R5 (register bank 0) and directs it to the console device. Any 
console device may be selected (i.e. UO or U1 or the software serial port). 
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9.2 GENERAL PURPOSE ROUTINES 

OPBYTE = 144 (90H) OUTPUT THE NUMBER ON THE TOP OF ARGUMENT STACK TO 
THE CONSOLE DEVICE. 

The floating point number that is on the top of the argument stack is outputted to the console device. The 
FORMAT is determined by the USING statement. The argument stack is POPPED after the output operation. 

OPBYTE = 154 (9AH) THE 16 BIT NUMBER REPRESENTED BY REGISTER PAIR R2:R0 IS 
PUSHED ON THE ARGUMENT STACK. 

This instruction converts the 16 bit register pair R2:R0 to a floating point number and pushes this number 
onto the argument stack. This instruction is the converse of the OPBYTE - 1 instruction. 
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9.3 UNARY OPERATORS 

The next group of instructions perform an operation on the number that is on the TOP of the ARGUMENT 
STACK. If the TOP of the ARGUMENT STACK is represented by the symbol [TOS], then the following 
instructions would take the general form: 

[TOS] < OP [TOS] 

Where OP is one of the following operators: 


OPBYTE = 24 (18H) — ABSOLUTE VALUE 

[TOS] < ABS([TOS]). The [TOS] is replaced by the absolute value of [TOS], 


OPBYTE = 25 (19H) — INTEGER 

[TOS] < INT([TOS]). The [TOS] is replaced by the integer portion of [TOS]. 


OPBYTE = 26 (1AH) — SIGN 

[TOS] < SGN([TOS]). If [TOS] > 0 then [TOS] = 1, if [TOS] = 0 then [TOS] = 0, and if [TOS] < 0 
then [TOS] = -1. 


OPBYTE = 27 (IBM) — ONE’S COMPLEMENT 

[TOS] < NOT([TOS]). [TOS] must be a valid integer. 


OPBYTE = 28 (1CH) — COSINE OPERATOR 

[TOS] < COS([TOS]). [TOS] must be between ±200000. 


OPBYTE = 29 (1DH) — TANGENT OPERATOR 

[TOS] < TAN([TOS]). [TOS] must be between ±200000 and [TOS] cannot equal PI/2, 3*PI/2, 5*PI/2, 
. . . . (2*N + l)*PI/2. 
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OPBYTE = 30 (1EH) — SINE OPERATOR 

[TOS] < SIN([TOS]). [TOS] must be between ±200000. 

OPBYTE = 31 (1FH) — SQUARE ROOT 

[TOS] < SQR ([TOS]). [TOS] must be > = 0. 

OPBYTE = 32 (20H) — CBY OPERATOR 

[TOS] < CBY ([TOS]). [TOS] must be a valid integer. 

OPBYTE = 33 (21H) — E TO THE [TOS] OPERATOR 

[TOS] < e(2.7182818)**[TOS]. e is raised to the [TOS] power. 

OPBYTE = 34 (22H) — ATN OPERATOR 

[TOS] < ATN([TOS]). Arctangent, the value returned is between ± PI/2. 

OPBYTE = 35 (23H) — LOG OPERATOR (natural LOG) 

[TOS] < LOG([TOS]) — [TOS] must be > 0. 

OPBYTE = 36 (24H) — DBY OPERATOR 

[TOS] < DBY([TOS]). [TOS] must be between 0 and 255 inclusive. 

OPBYTE = 37 (25H) — XBY OPERATOR 

[TOS] < XBY([TOS]). [TOS] must be a valid integer. 
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9.4 SPECIAL OPERATORS 

The next group of instructions place a value on the stack. The value placed on the stack is as follows: 


OPBYTE = 38 (26H) — PI 

[TOS] = PI. PI (3.1415926) is placed on the [TOS]. 


OPBYTE = 39 (27H) — RND 

[TOS] = RND. A random number is placed on the [TOS]. 


OPBYTE = 40 (28H) — GET 

[TOS] = GET. The value of the SPECIAL FUNCTION OPERATOR, GET is put on the [TOS]. 

OPBYTE = 41 (29H) — FREE 

[TOS] = FREE. The value of the SYSTEM CONTROL VALUE, FREE is put on the [TOS]. 

OPBYTE = 42 (2AH) — LEN 

[TOS] = LEN. The value of the SYSTEM CONTROL VALUE, LEN is put on the [TOS]. 

OPBYTE = 43 (2BH) — XTAL 

[TOS] = XTAL. The value of the SPECIAL FUNCTION OPERATOR, XTAL is put on the [TOS]. 

OPBYTE = 44 (2CH) — MTOP 

[TOS] = MTOP. The value of the SYSTEM CONTROL VALUE, MTOP is put on the [TOS]. 
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OPBYTE = 45 (2DH) — TIME 

[TOS] = TIME. The value of the SPECIAL FUNCTION OPERATOR, TIME is put on the [TOS]. 


OPBYTE = 46 (2EH) — IE 

[TOS] = IE. The value of the IE register is put on the [TOS]. 


OPBYTE = 47 (2FH) — IP 

[TOS] = IP. The value of the IP register is put on the [TOS]. 


OPBYTE = 48 (30H) — TIMERO 

[TOS] = TIMERO. The value of TIMERO (TH0:TL0) is put on the [TOS]. 


OPBYTE = 49 (31H) — TIMER1 

[TOS] = TIMERl. The value of TIMERl (THLTLl) is put on the [TOS]. 


OPBYTE = 50 (32H) — TIMER2 

[TOS] = TIMER2. The value of TIMER2 (TH2:TL2) is put on the [TOS]. 


OPBYTE = 51 (33H) — T2CON 

[TOS] = T2CON. The value of the T2CON register is put on the [TOS]. 


OPBYTE = 52 (34H) — TCON 

[TOS] = TCON. The value of the TCON register is put on the [TOS]. 
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9.4 SPECIAL OPERATORS 

OPBYTE = 53 (35H) — TMOD 

[TOS] = TMOD. The value of the TMOD register is put on the [TOS]. 


OPBYTE = 54 (36H) — RCAP2 

[TOS] = RCAP2. The value of the RCAP2 registers (RCAP2H:RCAP2L) is put on the [TOS]. 


OPBYTE = 55 (37H) — PORT1 

[TOS] = PORTl. The value of the PORTl (PI) pins is placed on the [TOS]. 


OPBYTE = 56 (38H) — PCON 

[TOS] = PCON. The value of the PCON register is put on the [TOS]. 
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9.5 DUAL OPERAND OPERATORS 


The next group of instructions assume that TWO values are on the ARGUMENT STACK, If number on 
the TOP of the ARGUMENT STACK is represented by the symbol [TOS] and the number NEXT to TOP 
of the ARGUMENT STACK is represented by the symbol [NxTOS] and the ARGUMENT STACK 
POINTER is represented by the symbol AGSP, then the following instructions would take the general 
form: 


TEMPI = [TOS] 

TEMP2 = [NxTOS] 

AGSP < AGSP+ 6 
RESULT = TEMP2 OP TEMPI 
[TOS] = RESULT 

Where OP is one of the following operators to be described. NOTE that the group of instructions ALWAYS 
POP the ARGUMENT STACK by one FLOATING POINT NUMBER SIZE (i.e. 6 BYTES). 

ERRORS can be handled in two different ways with the ADD, SUBTRACT, MULTIPLY, and DIVIDE 
routines. One option is to let MCS BASIC-52 trap ERRORS, should they occur during the operation. With 
this option MCS BASIC-52 will print the appropriate error message to the console device. The other option 
passes a STATUS CODE to the user. After the operation the Accumulator contains the status code 
information. The Status information is as follows: 

ACC.O — ARITHMETIC UNDERFLOW 

ACC.l — ARITHMETIC OVERFLOW 

ACC.2 — RESULT WAS ZERO (not an error, just a condition) 

ACC.3 — DIVIDE BY ZERO 
ACC.4 — NOT USED, ZERO RETURNED 
ACC.5 — NOT USED, ZERO RETURNED 
ACC.6 — NOT USED, ZERO RETURNED 
ACC.7 — NOT USED, ZERO RETURNED 

If an ARITH. OVERFLOW or a DIVIDE BY ZERO ERROR occurs and the user is handling the error 
condition, the floating point processor will return a result of ± 99999999E4-127 to the argument stack. 
The user can do what they want to with this result (i.e. use it or waste it). An ARITH. UNDERFLOW 
ERROR will return to the argument stack a result of 0 (zero). 


118 




MCS® BASIC-52 


inter 


9.5 DUAL OPERAND OPERATORS 

MCS BASIC-52 can perform the following DUAL OPERAND OPERATIONS: 


OPBYTE = 9 (09H) EXPONENTIATION — The [NxTOS] value is raised to the [TOS] power. RESULT 
= [NxTOS] ** [TOS]. NOTE — [TOS] MUST BE LESS THAN 256. 


OPBYTE = 10 (OAH) MULTIPLY 

RESULT = [NxTOS] * [TOS]. If an ERROR occurs during this operation (i.e. ARITH. OVERFLOW 
or UNDERPT.OW) MCS BASIC-52 will trap the error and print the error message to the console device. 


OPBYTE = 136 (88H) MULTIPLY 

RESULT = [NxTOS] * [TOS]. If an error occurs during this operation, the status byte previously discussed 
will be returned to the user. 


OPBYTE = 11 (OBH) ADD 

RESULT = [NxTOS] -f [TOS]. BASIC handles errors. 


OPBYTE = 130 (82H) ADD 

RESULT = [NxTOS] -t- [TOS]. User handles errors. 


OPBYTE = 12 (OCH) DIVIDE 

RESULT = [NxTOS] / [TOS]. BASIC handles errors. 


OPBYTE = 138 (8AH) DIVIDE 

RESULT = [NxTOS] / [TOS]. User handles errors. 


OPBYTE = 13 (ODH) SUBTRACT 

RESULT = [NxTOS] - [TOS]. BASIC handles errors. 
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OPBYTE = 132 (84H) SUBTRACT 


RESULT = [NxTOS] - [TOS], User handles errors. 


OPBYTE = 14 (OEH) EXCLUSIVE OR 

RESULT = [NxTOS] XOR [TOS], both values must be GREATER THAN OR EQUAL TO ZERO and 
LESS THAN OR EQUAL TO 65535 (OFFFFH). 

OPBYTE = 15 (OFH) LOGICAL AND 

RESULT = [NxTOS] and [TOS], both values must be GREATER THAN OR EQUAL TO ZERO and 
LESS THAN OR EQUAL TO 65535 (OFFFFH). 

OPBYTE = 16 (10H) LOGICAL OR 

RESULT = [NxTOS] OR [TOS], both values must be GREATER THAN OR EQUAL TO ZERO and 
LESS THAN OR EQUAL TO 65535 (OFFFFH). 

OPBYTE = 18 (12H) TEST FOR EQUALITY 

IF [NxTOS] = [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 

OPBYTE = 19 (13H) TEST FOR GREATER THAN OR EQUAL 

IF [NxTOS] > = [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 

OPBYTE = 20 (14H) TEST FOR LESS THAN OR EQUAL 

IF [NxTOS] < = [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 
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OPBYTE = 21 (15H) TEST FOR NOT EQUAL 

IF [NxTOS] <> [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 

OPBYTE = 22 (16H) TEST FOR LESS THAN 

IF [NxTOS] < [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 

OPBYTE = 23 (17H) TEST FOR GREATER THAN 

IF [NxTOS] > [TOS] then, RESULT = 65535 (OFFFFH), else RESULT = 0. 
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9.6 ADDED LINK ROUTINES TO VERSION 1.1 

Version 1.1 of MCS BASIC-52 contains a number of useful assembly language link routines that were 
not available in Version 1.0. Most of these routines were designed to be used in conjunction with the new 
Command/Statement extensions that are described in Chapter 11 of this manual. The added link routines 
are as follows: 

OPBYTE = 57 (39H) EVALUATE AN EXPRESSION WITHIN THE BASIC TEXT STRING AND 
PLACE THE RESULT ON THE ARGUMENT STACK 

This routine permits the user to evaluate a BASIC expression [expr] containing variables, operators and 
constants. The result of the evaluated expression is placed on the floating point argument stack. This lets 
the user evaluate expressions in “customized” statements and commands. An example of use of this 
OPBYTE is given at the end of this section. 

OPBYTE = 58 (3AH) PERFORM CRYSTAL DEPENDENT CALCULATIONS WITH THE 
VALUE THAT IS ON THE ARGUMENT STACK 

This routine is provided mainly to let the user write an assembly language RESET routine and perform all 
of the crystal dependent calculations that are required by MCS BASIC-52. An example of a customized 
RESET routine that uses this OPBYTE is presented in Chapter 11 of this manual. 

OPBYTE = 63 (3FH) GET A CHARACTER OUT OF THE BASIC TEXT STRING 

This routine permits the user to “pick” a character out of the BASIC program. For instance, in BASIC 
the user could have the following: 


10 CALLIOOOHA 

If the user executed the following in assembly language at lOOOH: 

MOV A, #63 

LCALL 30H 

The character A would be returned in the accumulator. The Basic text pointer is located in location 8 (8H) 
(low byte) and 10 (OAH) (high byte) of the internal ram on the MCS BASIC-52 device. If the user were 
to implement the above function, the basic text pointer must be advanced to the carriage return at the end 
of the statement before returning back to Basic. Failure to do this will cause a BAD SYNTAX ERROR 
when the user returns back to Basic. The following OPBYTE can be used to advance the Basic Text 
pointer. 


122 




MCS® BASIC-52 


iny 


9.6 ADDED LINK ROUTINES TO VERSION 1.1 

OPBYTE = 64 (40H) GET CHARACTER, THEN INCREMENT TEXT POINTER 

This OPBYTE does the same thing as the previous one described, except that the BASIC text pointer is 
INCREMENTED AFTER the character is read. An example of this OPBYTE is presented at the end of 
this section. 

OPBYTE = 65 (41H) INPUT A CHARACTER FROM THE CONSOLE DEVICE, PUT IT IN 
THE ACCUMULATOR, THEN RETURN 

This OPBYTE permits the user to input characters from MCS BASIC-52’s console input routine. The 
character is placed in the accumulator upon return. 

OPBYTE = 66 (42H) ENTER THE RUN MODE 

This OPBYTE permits the user to start the execution of an MCS BASIC’52 program from assembly 
language. The user need only insure that locations 19 (13H) and 20 (14H) of internal data memory contain 
the start address (high byte, low byte respectively) of the BASIC program. 

OPBYTE = 129 (81H) INPUT AN ASCII FLOATING POINT NUMBER AND PLACE IT ON 
THE ARGUMENT STACK. THE DPTR POINTS TO THE EXTERNAL 
RAM LOCATION, WHERE THE ASCII TEXT STRING IS STORED 

This routine assumes that the user has placed an ASCII text string somewhere in memory and that this 
ASCII text string represents a valid floating point number. The user then puts the DPTR to the starting 
address of this text string. After this OPBYTE is executed the text string will be converted to a valid MCS 
BASIC-52 floating point number and placed on the argument stack and the DPTR will be advanced to the 
end of the floating point number. If the DPTR does not point to a text string that contains a valid floating 
point number, the accumulator will contain an OFFH upon return. 

OPBYTE = 152 (98) OUTPUT, IN HEX, TO THE CONSOLE OUTPUT DRIVER, THE 
CONTENTS OF R3:R1 

This routine is used to display HEX numbers, assuming that they are in registers R3:R1. If R3 = 0, 
leading zeros can be supressed by setting BIT 54 (36H) before calling this routine. If BIT 54 (36H) is 
cleared when this routine is called, the driver will always output four hex digits followed by the character 
H. This routine always outputs a space character (20H) to the console device, before any hex digits are 
output. BIT 54 (36H) is bit 6 of internal RAM location 38. 
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I1CS-51 MACRO ASSEMBLER 

ISIS-II MCS-51 MACRO ASSEMBLER VI. 0 
OBJECT MODULE PLACED IN :F4: DEMO. HEX 
ASSEMBLER INVOKED BY: ASM51 :F4:DEMO 


LOC OBJ 


LINE SOURCE 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 


I 

I The folloming is an example of a program that uses the new OPBYTES 
f available in version 1. 1 of MCS BASIC-52. This code is by no means 
I optimized* but it is meant to demonstrate how the user can define 
j “customized" commands and statements in version 1. 1 of MCS BASIC-52. 

j 

i The new command defined here is DISPLAY. What it does is display a 
I region of external data memory to the console device. The syntax 
i for this statement is: 


DISPLAY Cexprl, Cexprl 

Where the first expression is the starting address and the last 
expression is the ending address. In this example the DISPLAY is 
treated like a command which means that it cannot be executed in 
RUN mode. 

The output for the DISPLAY command is as follows: 

ADDRESS then 16 Bytes of Characters i.e. 

lOOOH OOH 22H 33H 27H . 

Now* on to the program. 


m 


s 


■o 

r- 

ITI 


(O 

b> 


> 

D 

O 

m 

o 


o 


H 

O 


< 

m 

39 

O 



o 

(O 

@ 


cs 

> 


U) 

o 


Ol 

lO 
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LOG 

OBJ 

LINE 

SOURCE 





27 




2002 


28 

ORG 

2002H 




29 




2002 

5A 

30 

DB 

5AH i 

Tell basic that expansion option is 



31 


f 

present 

2048 


32 

ORG 

2048H 




33 




2048 

D22D 

34 

SETB 

45 ; 

Set the bit that sags so 

204A 

22 

35 

RET 





36 




2070 


37 

ORG 

2070H i 

Set up DPTR to jump table 



38 




2070 

90207C 

39 

MOV 

DPTR,#VECTOR TABLE 

2073 

22 

40 

RET 





41 




2078 


42 

ORG 

2078H t 

Set up DPTR to expansion table 



43 




2078 

90207E 

44 

MOV 

DPTR.#USER_TABLE 


207B 

22 

45 

RET 





46 






47 

VEGTOR^TABLE: 





48 




207C 

2087 

49 

DW 

DO_DISPLAY 1 

This is the address of DISPLAY 



50 






51 

USER^TABLE: 





52 




207E 

10 

53 

DB 

lOH 

Token for Display 

207F 

44495350 

54 

DB 

'DISPLAY' j 

ASCII for display 

2083 

4C4159 




2086 

FF 

55 

DB 

OFFH i 

End of table (short table) 



56 






57 






58 






59 

DO_DISPLAY: 





60 




2087 

302F63 

61 

JNB 

47,DUMMY i 

make sure that MGS BASIC-52 is in 



62 


f 

the command mode. Bit 47 is set 



63 


} 

if it is. 



64 




208A 

7439 

65 

MOV 

A, #57 } 

Evaluate the first expression after 

208C 

120030 

66 

LG ALL 

30H i 

the keyuiord display, MGS BASIC-52 



67 


i 

will handle any errors. The value 



68 


1 

of the expression will be on the 



69 


i 

Argument Stack 



70 





9.6 ADDED LINK ROUTINES TO VERSION 1.1 
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LOG OBJ 


LINE 


SOURCE 


208F 7440 71 

2091 120030 72 

73 

2094 B42C6A 74 

75 

76 

2097 7439 77 

2099 120030 78 

79 

80 

209C 7401 81 

209E 120030 82 

83 

84 

20A1 8918 85 

20A3 8B19 86 

87 

88 

20A5 7401 89 

20A7 120030 90 

91 

92 

20AA 891A 93 

20AC 8B1B 94 

95 

96 

97 

20AE C3 98 

20AF E518 99 

20B1 951A 100 

20B3 E519 101 

20B5 951B 102 

20B7 5004 103 

20B9 E4 104 

20BA 020030 105 

106 

107 

108 

20BD 7407 109 

20BF 120030 110 

111 

20C2 A91A 112 

20C4 ABIB 113 

114 

115 


MOV AI #64 

LCALL 30H 

CJNE Ai#S'iC 


MOV A, #57 

LCALL 30H 


MOV A,#l 

LCALL 30H 


MOV 18H,R1 

MOV 19H,R3 


MOV A, #1 

LCALL 30H 


MOV lAH,R1 

MOV IBH,R3 


LOOPl: CLR C 

MOV Ai 18H 

SUBB A»lAH 

MOV A, 19H 

SUBB A. IBM 

JNC L00P2 

CLR A 

LUMP 30H 


L00P2! MOV A, #7 

LCALL 30H 

MOV Rl, lAH 

MOV R3, IBH 


20C6 C236 


CLR 


36H 


; Get the character after the expression 
i and bump the BASIC text pointer 

/ Make sure it is a comma# if not do an 
I error 

I Evaluate the next expression (the 
t ending address) and put it on the 
j Argument Stack 

I Convert the last expression (the 
I ending address) on the stack to 
i an integer and put it in R3:R1 

f Save the ending address in the user 
I reserved locations 18H and 19H. This 
i is reserved as register bank 3 

I Convert the first expression (the 
i starting address) on the stack to 
» an integer and put it in R3:R1 

j Save the starting address in the user 
; reserved locations lAH and IBH 

i Now everything is set up to loop 

i Check to make sure that the starting 
f or current address is the ending 
i address 


CO 

b> 

> 

o 

o 

m 

D 



; If the carry is set# it's over 

# Go to the command mode 

t (if display uias a statement instead 

# of a command# this routine luould 

# exit with a RET 

} Do a carriage return# line feed 
I Output the Starting address 
i Don't supress leading zeros 
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LOG 

OBJ 

LINE 

SOURCE 





20C8 

7498 

116 

MOV 

A# #98H 




20CA 

120030 

117 

LCALL 

30H 






118 






20CD 

851A82 

119 

L00P3: MOV 

DPL,lAH 


t 

Notifi set up to read 16 bytes 

20D0 

801B83 

120 

MOV 

DPH, IBH 


/ 

put address in DPTR 



121 






20D3 

EO 

122 

MOVX 

Ai®DPTR 


f 

Read the byte in external RAM 

20D4 

A3 

123 

INC 

DPTR 


f 

Bump to the next location 
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20D5 

85821A 

125 

MOV 

lAH,DPL 


} 

Save the Address 

20D8 

85831B 

126 

MOV 

IBH,DPH 






127 






20DB 

F9 

128 

MOV 

Rl, A 


i 

Output the byte 

20DC 

7B00 

129 

MOV 

R3, #0 


f 

The high byte is aluiays zero 

20DE 

0236 

130 

SETS 

36H 


1 

Supress leading Zeros 

20E0 

7498 

131 

MOV 

A,#98H 




20E2 

120030 

132 

LCALL 

30H 






133 






20E5 

ESIA 

134 

MOV 

Ai lAH 


f 

Check to see if on a 16 byte boundry 

20E7 

540F 

135 

ANL 

Ai #0FH 




20E9 

70E2 

136 

JNZ 

L00P3 


f 

Loop until on a 16 Byte Boundry 

20EB 

80C1 

137 

SJMP 

LOOPl 






138 








139 

OUMMY: 







140 






20ED 

7407 

141 

MOV 

Ai #7 


i 

Do a carriage return-line feed 

20EF 

120030 

142 

LCALL 

30H 






143 






20F2 

7B21 

144 

MOV 

R3i #HIGH 

D MSG 

i 

Display the error message 

20F4 

7915 

145 

MOV 

Rli#LON 0 

L.MSG 



20F6 

0234 

146 

SETS 

52 


i 

Print from ROM 

20F8 

7406 

147 

MOV 

Ai #6 




20FA 

120030 

148 

LCALL 

30H 




20FD 

E4 

149 

CLR 

A 


i 

Go back to the command mode 

20FE 

020030 

150 

LUMP 

30H 






151 








152 

C_ERROR: 







153 






2101 

7407 

154 

MOV 

Ai #7 


1 

Do ufhat uie did before 

2103 

120030 

155 

LCALL 

30H 






156 






2106 

7B21 

157 

MOV 

R3i#HI0H 

C MSG 



2108 

793B 

158 

^ MOV 

Rli#LON C 

_MSG 



210A 

0234 

159 

SETS 

52 




210C 

7406 

160 

MOV 

Ai #6 




210E 

120030 

161 

LCALL 

30H 








128 


LOC 

OBJ 

LINE 

SOURCE 


2111 

E4 

162 


CLR 

2112 

020030 

163 

164 


LUMP 

2115 

44495350 

165 

D_MSO: 

DB 


2119 4C415920 
21ID 49532041 
2121 20434F4D 
2125 4D414E44 
2129 2C204E4F 
212D 54204120 
2131 53544154 
2135 454D454E 
2139 5422 

166 

213B 594F5520 167 C_MSG: DB 

213F 4E454544 

2143 20412043 

2147 4F4D4D4i 

214B 20544F20 

214F 4D414B45 

215320444953 

2157 504C4159 

215B 20574F52 

215F 4B22 

168 

169 END 


A 

30H 

'DISPLAY IS A COMMAND, NOT A STATEMENT”' 


'YOU NEED A COMMA TO MAKE DISPLAY WORK”' 



ASSEMBLY COMPLETE, NO ERRORS FOUND 
(that's all it takes) 
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9.7 INTERRUPTS 

Interrupts can be handled by MCS BASIC-52 in two distinct ways. The first, which has already been 
discussed, allows statements in an MCS BASIC-52 program to perform the required interrupt routine. The 
ONTIME and ONEXl statements enable this particular interrupt mode. Additionally, setting BIT 26. IH 
permits EXTERNAL INTERRUPT 0 to act as a “fake” DMA input and the details of this feature are in 
the BELLS, WHISTLES, and ANOMALIES section of this manual. The second method of handling 
interrupts in MCS BASIC-52 allows the programmer to write assembly language routines to perform the 
interrupt task. This method yields a much faster interrupt response time, but, the programmer must exercise 
some caution. 

All interrupt vectors on the MCS BASIC-52 device are “mirrored” to external PROGRAM MEMORY 
LOCATIONS 4003H through 402BH inclusive. The only MCS BASIC-52 STATEMENTS that enable the 
interrupts on the 8052AH are the CLOCK 1 and the ONEXl STATEMENTS. If interrupts are NOT enabled 
by these STATEMENTS, BASIC assumes that the USER is providing the interrupt routine in assembly 
language. The vectors for the various interrupts are as follows: 

LOCATION—INTERRUPT 

4003H-EXTERNAL INTERRUPT 0 

400BH-TIMER 0 OVERFLOW 

4013H-EXTERNAL INTERRUPT 1 

401BH-TIMER 1 OVERFLOW 

4023H-SERIAL PORT 

402BH-TIMER 2 OVERFLOW/EXTERNAL INTERRUPT 2 

The programmer can enable interrupts in MCS BASIC-52 by using the statement IE = lE.OR.XXH, where 
XX enables the appropriate interrupts. The bits in the interrupt register (IE) on the 8052AH are defined 
as follows: 


BIT 7 

6 

5 

4 

3 

2 

1 

0 

EA 

X 

ET2 

ES 

ETl 

EXl 

ETO 

EXO 

ENABLE 

ALL 

UNDE¬ 

FINED 

TIMER 2 

SERIAL 

PORT 

TIMER 1 

EXT 1 

TIMER 0 

EXTO 
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9.7 INTERRUPTS 

Interrupts are enabled when the appropriate BITS in the IE register are set to a one. Details of the 8052AH 
interrupt structure are available in the MICROCONTROLLER USERS MANUAL available from INTEL. 

~ IMPORTANT NOTE!! 


Before MCS BASIC-52 vectors to the USER interrupt locations just described, the PROCESSOR STATUS 
WORD (PSW) is PUSHED onto the STACK. So, the USER does not have to save the PSW in the assembly 
language interrupt routine!!! HOWEVER, THE USER MUST POP THE PSW BEFORE RETURNING 
FROM THE INTERRUPT 


VERY IMPORTANT NOTE!!! 


If the user is running some interrupt driven “background” routine while MCS BASIC-52 is running a 
program, the user MUST NOT CALL any of the assembly language routines available in the MCS BASIC-52 
device. The only way the routines in the MCS BASIC-52 device can be accessed is when the CALL 
statement in MCS BASIC-52 is used to transfer control to the users assembly language program. The 
reason for this is that the MCS BASIC-52 interpreter must be in a “known” state before the user can call 
the routines available in the MCS BASIC-52 device and a “random” interrupt does not guarantee that the 
interpreter is in this known state. The user should use REGISTER BANK 3 to handle interrupt routines 
in assembly language. 


130 







MCS® BASIC-52 


inl^ 


9.8 RESOURCE ALLOCATION 

Specific statements in MCS BASIC-52 require the use of certain hardware features on the device. If the 
user wants to use these hardware features for interrupt driven routines, conflicts between BASIC and the 
assembly language routine may occur. To avoid these potential conflicts, the programmer needs to know 
what hardware features are used by MCS BASIC-52. The following is a list of the COMMANDS and/or 
STATEMENTS that use the hardware features on the 8052AH. 

CLOCKl — uses TIMER/COUNTER 0 in the 13 bit 8048 mode. 

PWM — uses TIMER/COUNTER 1 in the 16 bit mode 

LIST# — uses TIMER/COUNTER 1 to generate baud rate in 16 bit mode 

PRINT# — same as LIST# 

PROG — uses TIMER/COUNTER 1 for programming pulse 
ONEXl — uses EXTERNAL INTERRUPT 1 

In addition, TIMER/COUNTER 2 is used to generate the baud rate for the serial port. What the preceding 
list means is that if CLOCKl, PWM, ONEXl, LIST#, PRINT#, and PROG commands/statements are 
used by the programmer, the user MAY NOT use the associated TIMER/COUNTER or EXTERNAL 
INTERRUPT pin for an assembly language routine. 

MCS BASIC-52 initializes the TIMER/COUNTER modes by writing a 244 (0F4H), 16 (lOH), and 52 
(34H) to the TCON, TMOD, and T2CON registers respectively. These registers are initialized only during 
the RESET initialization sequence, and MCS BASIC-52 assumes that these registers are NEVER changed. 
So, if the user changes the contents of TCON, TMOD, or T2CON, something funny and/or disastrous is 
bound to happen if the Statements/Commands listed above are executed. If the user does not execute any 
of the previously mentioned Statements or Commands, the user is free to use the interrupts in any way 
suitable to the application. 
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CHAPTER 10 
System Configuration 


10.1 MEMORY/HARDWARE CONFIGURATION 

MGS BASIC-52 always requires at least IK bytes of external memory. After reset, MGS BASIC-52 sizes 
the external memory. If less than IK bytes of external memory are available, MGS BASIC-52 will not 
“sign-on,” in fact, it will intemally loop forever. This obviously is not too exciting, so it is wise to hang 
some external memory on the MGS BASIC-52 device. 

MGS BASIC-52 sizes consecutative external memory locations from OOOOH until a memory failure is 
detected. The sizing operation is performed simply by writing a 5AH to an external memory location, then 
testing the location. If the particular memory location passes this test, BASIC then writes a OOH to the 
location, then again, checks the location. MCS BASIC-52 only sizes the external memory from locations 
0 through ODFFFH. Memory locations OEOOOH through OFFFFH are reserved for user I/O and/or assembly 
language programs. 

The MCS BASIC-52 program resides in the 8K of ROM available in INTEL’S 8052AH device and as a 
result requires that external memory be “partitioned” in a specific manner. The architecture of the 8052AH 
is NOT Von Neumann. This means that Data and Program Memory do not reside in the same physical 
address space on the 8052AH. Sp ecifical ly, the RD (pin 17) and WR (pin 16) pins on the 8052AH are 
used to enable DATA memory and PSEN (pin 29) pin is used to enable PROGRAM memory. Depending 
on the hardware configuration, MCS BASIC-52 operates in two distinct “memory” modes. 

RAM ONLY MODE 

In this mode of operation. Read/write memory is connected to the MCS BASIC-52 device starting at 
memory address OOOOH. Memory can be placed up to location OFFFFH. In this mode of operation the 
decoded addresses are used to generate the CHIP SELECT (CS) signal for the RAM devices. The RD pin 
on the 8052AH is used to gen erate the OUT PUT ENABLE (OE) strobe and the WR pin generates the 
WRITE ENABLE (WE or WR) strobe. PSEN is not used in the RAM only mode of operation. The RAM 
only mode of operation offers the simplest hardware configuration available for the MCS BASIC-52 
device. An example of this configuration is shown in Figure 1. Since PSEN is not used in the RAM only 
mode, the user may not CALL assembly language routines. The RAM only also does not support EPROM 
programming. In general, the RAM only mode will be used only to “check out” the device during the 
initial system development stage. 
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10.1 MEMORY/HARDWARE CONFIGURATION 

RAM/EPROM MODE 

The RAM/EPROM mode of operation allows for the complete system implementation of MCS BASIC-52. 
This mode of operation requires that external memory be mapped in a certain manner. The RAM/EPROM 
memory configuration is as follows: 

1) The RD and the WR pins on the MCS BASIC-52 device are used to enable RAM memory that is 
addressed from OOOOH to 7FFFH. Addresses are used to de co de th e chip select (CS) for the RAM 
devices and RD and WR are used to enable the OE and WE or (WR) pins respectively. 


2) The PSEN pin on the MCS BASIC-52 device is used to enable EPROM memory that is addressed from 
2000H to 7FFFH. Addresses are used to decode the chip select (CS) for the EPROM devices and PSEN 
is used to enable the OE pin. 


3) For addresses between 8000H and OFFFFH both the RD and the PSEN pin on the MCS BASIC-52 
device are used to enable the memory. Either EPROM or RAM devices can be placed in this address 
space. To permit both the RD and the PSEN pins to enable addresses in this address space, RD and 
PSEN must be logi cally “ANDED” together. This can be accomplished with a simple TTL gate such 
as a 74LS08. The WR pi n on t he MCS BASIC-52 device is used to write to RAM memory in this 
same address space. The PSEN and RD signals do not have to be anded beyond address 7FFFH to 
enable MCS BASIC-52 to program an EPROM. This is only a suggestion since it will permit the user 
to execute assembly language routines as well as MCS BASIC-52 programs that are located in this 
address space. 
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10.1 MEMORY/HARDWARE CONFIGURATION 

This scheme of memory addressing actually permits MCS BASIC-52 to address 96K bytes of memory, 
32K of RAM devices , 32K of EPROM/ROM devices and 32K of combined RAM/EPROM/ROM devices. 
Since RD and PSEN are ANDED for addresses from 8000H through OFFFFH, the 8052AH “looks like” 
a Von Neumann machine in this address space. The XBY and CBY special function operators will yield 
the same value when their arguments are between 8000H and OFFFFH. 

When the EPROM programming feature in MCS BASIC-52 is used, BASIC assumes that the EPROM to 
be programmed is addressed starting at location 8000H. MCS BASIC-52 can only program EPROMS 
addressed between 8000H and OFFFFH. When the PROG command is used for the first time, on an erased 
EPROM, MCS BASIC-52 stores this program beginning at address 801 OH. Locations 8000H through 
800FH are used to save the baud rate information, plus configuration information. Some suggestions for 
implementation of the RAM/EPROM mode are shown in figure 2. 
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10.2 EPROM PROGRAMMING CONFIGURATION/TIMING 

With the proper hardware, the MCS BASIC-52 device can program just about any EPROM or EEPROM 
device. The only requirement for EPROM programming is that the EPROM to be programmed is addressed 
starting at location 8000H. MCS BASIC-52 requires very little external hardware to programs EPROMS. 
All of the critical EPROM programming timings are generated by threel/O port pins on the MCS BASIC-52 
device. These pins provide the following signals: 

P1.3 — ALE DISABLE 

PORT 1, BIT 3 (pin 4 on the 8052AH) is used to DISABLE the ALE signal to the external latched required 
by the 8052AH when external memory is addressed. This pin should be logically ANDED with ALE. A 
simple TTL gate, such as a 74LS08 can be used to perform the ANDING function. Under normal operation, 
P1.3 is in a logical high state (1). ONLY DURING EPROM PROGRAMMING IS PI.3 PLACED IN A 
LOGICAL LOW STATE (0). Disabling the ALE signal to the external latch is required to program EPROMS 
because of the way MCS BASIC-52 carries out the EPROM programming process. 

During programming, MCS BASIC-52 treats I/O PORT 0 and I/O PORT 2 as I/O ports, not as address/ 
data ports. MCS BASIC-52 first writes the low order address to be programmed to PORT 0. The data in 
PORT 0 is then latched into the external address latch and then MCS BASIC-52 disables the ALE signal 
to the latch by clearing bit P1.3. Thus, the low order address is “permanently” stored in the external 
latch. MCS BASIC-52 then writes the high order address to PORT 2 and the DATA to be programmed 
to PORT 0. So, the external address latch contains the low order address, PORT 2 contains the high order 
address, and PORT 0 contains the DATA when EPROM programming occurs. 

IMPORTANT NOTES 

When PORT 0 on the 8052AH is used as an I/O port, the output structure is an “open drain” configuration. 
This requires that ‘ ‘pull-up’ ’ resistors be placed on PORT 0 to permit MCS B ASIC-52 to program EPROMS. 
Experimentally, lOK ohm pull-ups resistors on PORT 0 have yielded satisfactory results. 

In Version 1.1, INTO must be kept high when programming EPROMs. 


135 




MCS® BASIC-52 


inter 

10.2 EPROM PROGRAMMING CONFIGURATION/TIMING 

PI .4 — PROGRAM PULSE WIDTH 

PORT 1, BIT 4 (pin 5 on the 8052AH) is used to provide the 50 millisecond or the 1 millisecond 
programming pulse. The length of the programming pulse is determined by whether the “normal” or the 
“INTELligent” EPROM programming mode is selected. MCS BASIG-52 calculates the length of the 
programming pulse from the assigned crystal value. So, be sure the proper XTAL has been assigned. The 
accuracy of this pulse is within 10 CPU clock cycles. This pin is normally in a logical high (1) state. It 
is asserted low (0) to program the EPROMS. Depending on the EPROM to be programmed this signal 
will be used in different ways. More about this later. 

PI .5 — ENABLE PROGRAM VOLTAGE 

PORT 1, BIT 5 (pin 6 on the 8052AH) is used to enable the EPROM programming voltage. This pin is 
normally in a logical high (1) state. Prior to the EPROM programming operation, this pin is brought to a 
logical low (0) state. This pin is used to turn on or off the high voltage (12.5 volts to 25 volts, depending 
on the EPROM) required to program the EPROMS. 

The timing for the EPROM programming pins is shown in figure 3. The hardware required to program 
different devices is shown in figure 4. Note that with very little external hardware the MCS BASIC-52 
device can program virtually all commercially available EPROMS. Additionally, figure 5 suggests a circuit 
using an INTEL 28I6A EEPROM. This circuit also features a push button erase option. 

IMPORTANT NOTE 

MCS BASIC-52 calculates the programming pulse width when the XTAL value is assigned. To insure 
proper programming, make sure XTAL is assigned the proper value. MCS BASIC-52 performs the pro¬ 
gramming pulse width calculation to within 5 clock cycles, so the accuracy of the programming pulse is 
well within the limits of any EPROM device. 


10.3 SERIAL PORT IMPLEMENTATION 

The serial port I/O signals on the 8052AH are TTL compatible signals. They are typically not compatible 
with most terminals. Figure 6 suggests hardware options for making the serial interface compatible with 
terminals. The serial port is initialized by MCS BASIC-52 to the 8-bit uart mode. In this mode 8 data bits, 
plus one start and one stop bit are transmitted. Parity is not used. 
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Figure 1. Interface to 2K x 8 Static RAM 
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Figure 2A. Full system with EPROM power on protection (no DMA) 

This system will decode: RAM from 0 to 16K on 2K boundaries, EPROM from 0 to 32K on 8K boundaries, 
RAM/EPROM from 32K to 64K on 8K boundaries 
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Figure 2C. Programming 2817A’s with Version 1.0 of MCS BASiC-52 
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EPROM PROGRAMMING TIMING 


PI .5 

EPROM VOLTAGE ENABLE 



PORTO 


P1.3 

ALE DISABLE 


PORT 2 


P1.4 

PROGRAMMING PULSE 



TCY = 


12 

XTAL 


TCY = 1 us 
AT 12 MHz 


WHEN USING THE INTELLIGENT ALGORITHM (FPROG) 
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Figure 3A. EPROM Programming Timing Version 1.0 
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NOTE 1. This pulse is either 1 millisecond (INTELigent algorithm) or 50 milliseconds (normal algorithm). SAMPLED 


NOTE 2. When PROG command is executed, P1.5 goes low, and then the EPROM is read to see where to place the BASIC program. 


Figure 3B. EPROM programming timing for Version 1.1 
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Figure 4A. Programming 2764’s/27128’s 


Figure 4B. Programming 2732A’s 



Figure 4C. Programming 2716’s 
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-HOTO +15 VOLTS 



Figure 5. 2816A Circuit with Push Button Erase. 

(Basic-52 should be “Idle” in the command mode when the Erase Button is pushed.) 


+ 5 



Figure 6A. 

TWO TRANSISTORS TO IMPLEMENT RS-232. THE ‘NEGATIVE ” 
SUPPLY FOR THE SERIAL OUTPUT LINE IS TAKEN FROM THE 
SERIAL INPUT LINE. NO ±12 VOLT SUPPLY IS REQUIRED. 


SERIAL V 
INPUT ^ 


+ 5 

TO RXD ON 
-> BASIC-52 
DEVICE 

1/4 “ 1489 



SERIAL y 
OUTPUT ^ 


1/4 1488 


TO TXD ON 
^ BASIC-52 
DEVICE 


Figure 6B. 

USING THE STANDARD 1489 AND 1488 LINE RECEIVERS AND 
DRIVERS, ±12 VOLTS IS NEEDED WITH THIS IMPLEMENTATION. 
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CHAPTER 11 

Reset Options (Version 1.1 Oniy) 


Version 1.1 of MCS BASIC-52 contains numerous RESET options that were not available in Version 1.0. 
They are discussed in detail in chapters 3.2 through 3.5 of this manual. Briefly, they are as follows: 

PROG1 

Saves only the serial port baud rate for a power-up or RESET condition. 

PROG2 

Saves the serial port baud rate and automatically runs the first program that is saved in EPROM on a 
power-up or RESET condition. 

PROGS 

Saves the serial port baud rate plus the assigned MTOP value. If RAM is available beyond the assigned 
MTOP value, it will not be cleared during a power-up or RESET condition. 

PROG4 

Saves the serial port baud rate plus the assigned MTOP value, just like PROG3, but also automatically 
runs the first program that is saved in EPROM on a power-up or RESET condition. 

PROGS 

Does the same thing as PROG4, however, if external memory location 5FH contains the character 0A5H 
on a power-up or RESET condition, external memory will not be cleared. This mode assumes that the 
user has employed some type of memory back-up. 
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PROG6 

Does the same thing as PROG5, but CALLS external program memory location 4039H during a RESET 
or power-up sequence. This option also requires the user to put the character 0A5H in external memory 
location 5FH to insure that external RAM will not be cleared during RESET or power-up. The user must 
put an assembly language RESET routine in external memory location 4039H or else this RESET mode 
will crash. When the user returns from the customized assembly language RESET routine, three options 
exist: 

OPTION 1 FOR PROG6 

If the CARRY BIT is CLEARED (CARRY = 0) upon return from the user RESET routine MCS BASIC- 
52 will enter the auto-baud rate determining routine. The user must then type a space character (20H) on 
the terminal to complete the RESET routine and produce a RESET message on the terminal. 

OPTION 2 FOR PROG6 

If the CARRY BIT is SET (CARRY = 1) and BIT 0 of the ACCUMULATOR is CLEARED (ACC. 0 
= 0) MCS BASIC-52 will produce the standard sign-on message upon return from the user supplied 
RESET routine. The baud rate will be the one that was saved when the PROG6 option was used. 

OPTION 3 FOR PROG6 

If the CARRY BIT is SET (CARRY = 1) and BIT 0 of the ACCUMULATOR is SET (ACC. 0 = 1), 
MCS BASIC-52 will execute the first program stored by the user in EPROM (starting address of the 
program is 801 OH) upon return from the user supplied RESET routine. 
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If these options are still not sufficient to address the needs of a specific application, one other option exists 
and it functions as follows: 

After RESET, MCS BASIC-52 initializes the SPECIAL FUNCTION REGISTERS SCON, TMOD, TCON, 
and T2CON with the following respective values, 5AH, lOH, 54H, and 34H. If the user places the c haracte r 
OAAH in external CODE MEMORY location 200IH (remember CODE MEMORY is enabled by PSEN), 
MCS BASIC-52 will CALL external CODE MEMORY location 2090H immediately after these special 
function registers are initialized. No other registers or memory locations will be altered except that the 
ACCUMULATOR will contain a OAAH and the DPTR will contain a 200IH. 

Since MCS BASIC-52 does not write to the above mentioned Special Function Registers at any time except 
during the RESET or power-up sequence the user has the option of modifying any of the Special Function 
Registers with this RESET option. Upon returning from this RESET mode, the MCS BASIC-52 software 
package will clear the internal memory of the 8052AH and proceed with the RESET routine. The PROGl 
through PROG6 options will function as usual. 

Now, suppose the user does not want to enter the normal RESET routines, or the user wants to implement 
some type of “warm” start-up routine. This can be accomplished simple by initializing the necessary 
Special Function Registers and then jumping back into either MCS BASIC-52’s COMMAND mode or 
RUN MODE. For a warm start-up or RESET (warm means that the MCS BASIC-52 device was RESET, 
but power was not removed — i.e. the user hit the RESET button) the following must be initialized: 

SCON, TMOD, TCON, T2CON, if the user does not want to use the values that MCS BASIC-52 supplies. 

RCAP2H and RCAP2L must be loaded with the proper baud rate values. If the user has programmed an 
EPROM with one of the PROGl through PROG6 options, the proper baud rate value will be stored in 
external DATA MEMORY locations 8001H (RCAP2H) and 8002H (RCAP2L). 

The STACK POINTER (Special Function Register SP) must be initialized with the contents of the STACK 
POINTER SAVE location, which is in internal DATA MEMORY location 3EH. A MOV SP, 3EH assembly 
language instruction will accomplishment the STACK POINTER initialization. 
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After the above are initialized by the user supplied RESET routine, the user may enter MCS BASIC-52’s 
command mode by executing the following: 

CLR A 

LJMP 30H 

Now, it is important to remember that the previous description applies only to a “warm” RESET with 
power remaining to the MCS BASIC-52 system. This means that the user must also provide some way of 
detecting the difference between a warm RESET and a power-on RESET. This usually involves some type 
of flip-flop getting set with a power-on-clear signal from the users power supply. The details of imple- 
mentating this RESET detection mechanism will not be discussed here as the possible hardware options 
vary depending upon the design. 

The user may also implement a “cold start” reset option with the previously described reset mode. The 
following code details what is necessary to implement a cold start option. 

EXAMPLE: 


ORO 

i 

DB 


i 

ORG 

I 


# 


MOV 

CLR 

i 

RESETI: MOV 
DJNZ 


MOV 

MOV 


MOV 

MOV 

MOV 


2001H 


OAAH 


TELL BASIC THAT RESET IS EXTERNAL 


2070H 


LOCATION BASIC WILL CALL FOR RESET 


f AT THIS POINT BASIC HAS PLACED A 5AH IN 
I SCON, A lOH IN TMOD, A 54H IN TCON AND 
I A 34H IN T2CON 


RO,BOFFH 
A 


j FIRST CLEAR THE INTERNAL MEMORY 
I LOAD RO WITH THE TOP OF INTERNAL MEMORY 
I SET ACCUMULATOR « 0 


«RO,A t LOOP UNTIL ALL THE INTERNAL RAM IS CLEARED 

RO,RESET1 


8P,«4DH 
3EH, #4DH 


j NOW SET UP THE STACK POINTER AND THE STACK 
; POINTER HOLDING REGISTER 

I 4DH IS THE INITIALIZED VALUE OF THE STACK 
I THIS IS THE SP HOLDING REGISTER 


I NOW CLEAR THE EXTERNAL RAM, IN THIS 
i EXAMPLE ASSUME THAT IFFFH BYTES OF RAM 
t ARE AVAILABLE 

I THE USER MUST CLEAR AT LEAST THE FIRST 512 
» BYTES OF RAM FOR A COLD START RESET 


R3,#HIGH IFFFH 
Rl,#LOW IFFFH 
DPTR,#OFFFFH 
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RESET2: INC DPTR i DPTR = 0 THE FIRST TIME THRU 

CLR A 

MOVX ©DPTR,A I CLEAR THE RAM, A MEMORY TEST PROGRAM COULD 

I BE IN THIS LOOP 

MOV A. R3 ; NOW TEST FOR THE MEMORY LIMITS 

CJNE A, DPH, RESET2 

MOV A, R1 

CJNE A, DPL, RESET2 

t 

I WHEN YOU GET HERE, YOU ARE DONE 

i 

i NOW SET UP THE MEMORY POINTERS, FIRST MTOP 

i 

MOV DPTR,#10AH i LOCATION OF MTOP IN EXTERNAL RAM 

MOV A, #HIGH IFFFHi SAVE MTOP 

MOVX ©DPTR,A 

INC DPTR i NOW, SAVE THE LOW BYTE 

MOV A, #LOW IFFFH 

MOVX ©DPTR,A 

I 

) NOW SET UP THE VARTOP POINTER, WITH NO STRINGS, 

I VARTOP « MEMTOP 

i 

MOV DPTR,#104H i LOCATION OF VARTOP IN EXTERNAL RAM 

MOV A, #HIGH IFFFH 

MOVX «DPTR,A 

INC DPTR 

MOV A,#LOW IFFFH 

MOVX @DPTR,A 


I NOW SAVE THE MATRIX POINTER “DIMUSE**, THIS POINTER IS 
I DESCRIBED IN THE APPENDIX, WITH NO PROGRAM IN RAM, 
i DIMUSE » 528 AFTER RESET 

I 

MOV DPTR,#108H i LOCATION OF DIMUSE IN EXTERNAL RAM 

MOV A,#HIGH 528 

MOVX ©DPTR,A 

INC DPTR 

MOV A,#LOW 528 

MOVX ©DPTR,A 

i 

t NOW SAVE THE VARIABLE POINTER ”VARUSE" THIS POINTER IS 
I ALSO DESCRIBED IN THE APPENDIX, AFTER RESET VARUSE « VARTOP 

i 

MOV DPTR,#106H j LOCATION OF VARUSE IN EXTERNAL RAM 

MOV A,©HIGH IFFFH 

MOVX ©DPTR.A 

INC DPTR 

MOV A, ©LOW IFFFH 

MOVX ©DPTR.A 

i 

I NOW SETUP BASICS CONTROL STACK AND ARGUMENT STACK 

I 

MOV 9H, ©OFEH t THIS INITIALIZES THE ARGUMENT STACK 

MOV IIH,©OFEH I THIS INITIALIZES THE CONTROL STACK 

j 

J NOW TELL BASIC THAT NO PROGRAM IS IN RAM, THIS IS NOT NEEDED 
j IF THE USER HAS A PROGRAM IN RAM 

I 

MOV DPTR, ©512 i LOCATION OF THE START OF A USER PROGRAM 

MOV A, ©OlH i END OF FILE CHARACTER 

MOVX ©DPTR,A 
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; NOW PUSH THE CRYSTAL VALUE ON TO THE STACK AND LET BASIC 
J CALCULATE ALL CRYSTAL DEPENDENT PARAMETERS 




SJMP 

i 

XTAL: DB 

RESETS 



88H 

i 

THIS IS THE FLOATING POINT VALUE 

DB 

OOH 

i 

FOR AN 11.0592 MHZ CRYSTAL 

DB 

OOH 



DB 

92H 



DB 

05H 



DB 

1 

IIH 



1 

RESET3: MOV 

DPTR. #XTAL 

i 

SET UP TO PUSH CRYSTAL VALUE 

MOV 

A. 9 

i 

GET THE ARG STACK 

CLR 

C 



SUBB 

A. #6 

» 

DECREMENT ARG STACK BY ONE FP NUMBER 

MOV 

9. A 



MOV 

RO. A 

i 

SAVE THE CALCULATED ADDRESS IN RO 

MOV 

P2. #1 

J 

THIS IS THE ARG STACK PAGE ADDRESS 

MOV 

Rl. #6 

i 

NUMBER OF BYTES TO TRANSFER 

i 

RESET4: CLR 

A 

1 

TRANSFER ROM CRYSTAL VALUE TO THE 

Move 

A.SA+DPTR 

l 

ARGUMENT STACK OF BASIC 

MOVX 

eRO. A 



INC 

DPTR 

1 

BUMP THE POINTERS 

DEC 

RO 



DJNZ 

RliRESET4 

J 

LOOP UNTIL THE TRANSFER IS COMPLETE 

i 

i NOW 

CALL BASIC TO 

DO 

ALL THE CRYSTAL CACULATIONS 

i 

MOV 

A. #58 

; 

OPBYTE FOR CRYSTAL CALCULATION 

LCALL 

30H 

1 

DO THE CALCULATION 


; NOW TELL BASIC WHERE START OF THE USER BASIC PROGRAM IS 
i BY LOADING THE START ADDRESS. IF THE PROGRAM IS IN EPROM 
I I3H WOULD « HIGH 80UH AND 14H » LOW SOIIH, ANYWAY 
i ADDRESS 13H:14H MUST POINT TO THE START OF THE BASIC 
I PROGRAM 

i 

MOV 13H. #HIGH S12i THIS TELLS BASIC THAT THE START OF 

MOV 14H, #LOW 512 i THE PROGRAM IS IN LOCATION 512 

; 

,* NOW THE SERIAL PORT MUST BE INITIALIZED. THE USER 
s CAN SET UP THE SERIAL PORT TO ANY DESIRED CONFIGURATION 
j HOWEVER. THIS DEMO CODE WILL SHOW THE AUTO BAUD 
I ROUTINE 

I 

MOV R3.#O0H J INITIALIZE THE AUTO BAUD COUNTERS 

MOV Rl,#OOH 

MOV RO.#04H 

JB RXD.♦ j LOOP UNTIL A START BIT IS RECEIVED 
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I 

RESETS: DJNZ 

ROi« 


WASTE 8 CLOCKS INITIALLYi SIX CLOCKS 



1 

IN THE LOOP (16) TOTAL 

CLR 

C 

1 

1 CLOCK (1) 

MOV 

A.Rl 

1 

i CLOCK (2) 

SUBB 

A«#l 

1 

1 CLOCK (3) 

MOV 

Rl. A 

1 

1 CLOCK (4) 

MOV 

Ai R3 

i 

1 CLOCK (5) 

SUBB 

A« «00H 

J 

1 CLOCK “ R3:R1 » R3:R1 - 1 <6) 

MOV 

R3« A 

1 

1 CLOCK (7) 

MOV 

ROi #3 

1 

1 CLOCK (8) 

JNB 

RXD*RESETS 

1 

2 CLOCKS (10)i WAIT FOR END OF SPACE 

JB 

RXD» t 

1 

MAIT FOR THE SPACE TO END (20H> 

JNB 

RXDi« 

1 

WAIT FOR THE STOP BIT 

MOV 

RCAP2H. R3 

i 

LOAD THE TIMER 2 HOLDING REGISTERS 

MOV 

RCAP2L. Ri 



1 NOW 

YOU CAN ADD A 

CUSTOM SION ON MESSAGE 

MOV 

R3.#H10H MSO 

1 

PUT ADDRESS OF MESSAGE IN R3:R1 

MOV 

Ri.«Lou use 



SETB 

52 

1 

PRINT FROM ROM 

MOV 

Ai #6 

1 

OP BYTE TO PRINT TEXT STRING 

LCALL 

30H 



Z 

i 

OUTPUT A CR LF 



MOV 

A, #7 

1 

OP BYTE FOR CRLF 

LCALL 

30H 



} 00 TO THE COMMAND 

liODE 

CLR 

A 



JMP 

30H 



MSG: DB 

'CUSTOM SIGN 

ON MESSAGE' 

DB 

22H 

1 

TERMINATES MESSAGE 

END 





151 







MCS® BASIC^52 


inter 


RESET OPTIONS (VERSION 1.1 ONLY) 

To Summarize what the user must do to successfully implement a “COLD START’ ’ RESET: 

1) The user must clear the internal RAM of the MCS BASIC-52 device and at least the first 512 bytes of 
external RAM memory. 

2) The user must initialize the stack pointer (special function register — SP) and the stack pointer holding 
register (internal RAM location 3EH) with a value that is between 4DH and OEOH. 4DH gives MCS 
BASIC-52 the maximum stack size. 

3) The user must initialize the following pointers in external RAM. MTOP at location 10AH (high byte) 
and IQBH (low byte). VARTOP at locations 104H (high byte) and 105H (low byte). DIMUSE at 
locations 108H (high byte) and 109H (low byte). VARUSE at locations 106H (high byte) and 107H 
(low byte). Details of what needs to be in these locations are presented in appendix 1.7 of this manual. 

4) The Control stack pointer (location IIH in internal memory) and the Argument stack pointer (location 
09H in internal memory) must also be initialized with the value OFEH. If the user is not going to assign 
the XTAL (crystal) value in BASIC, then the XTAL value must be pushed onto the argument stack 
and the user must to an OPBYTE 58 call to MCS BASIC-52. 

5) The User must also initialize the start address of a program. The start address is in locations 13H (high 
byte) and 14H (low byte) of internal data memory. If the user BASIC program is in RAM, then 13H: 
14H = 512, if the user program is the the first program in EPROM, then 13H: 14H = 801IH. 

6) The user must finally initialize the serial port. Any scheme can be used (as long as it works!!) 

The added reset options should go a long way toward making MCS BASIC-52 configurable to any custom 

application. 
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CHAPTER 12 

Command/Statement Extensions (Version 1.1 Oniy) 


MCS BASIC-52 VI. 1 provides a simple, but yet effective way for the user to add COMMANDS and/or 
STATEMENTS to the ones that are provided on the chip. All the user must do is write a few simple 
programs that will reside in external code memory. The step by step approach is as follows: 

STEP1 

The user must first inform the MCS BASIC-52 device that the expansion options are available. This is 
done by putting the character 5AH in CODE memory location 2002H. When MCS BASIC-52 enters the 
command mode it will examine CODE memory location 2002H. If a 5AH is in this location, MCS BASIC- 
52 will CALL external CODE memory location 2048H. The user must then write a short routine to SET 
BIT 45 (2DH), which is bit 5 of internal memory location 37 (decimal) and place this routine at code 
memory location 2048H. Setting BIT 45 tells MCS BASIC-52 that the expansion option is available. The 
following simple code will accomplish all that is stated above: 


ORG 

2002H 

DB 

5AH 

OG 

2048H 

SETB 

45 

RET 



STEP 2 

With BIT 45 SET, MCS BASIC-52 will CALL external CODE memory location 2078H everytime it 
attempts to tokenize a line that has been entered. At location 2078H, the user must load the DPTR (Data 
Pointer) with the address of the user supplied lookup table, complete with tokens. 
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STEPS 


The user needs the following information to generate a user token table; 

1) THE USER TOKENS ARE THE NUMBRES lOH THROUGH IFH (16 TOKENS AVAILABLE) 

2) THE USER TOKEN TABLE BEGINS WITH THE TOKEN, FOLLOWED BY THE ASCII TEXT 
THAT IS TO BE REPRESENTED BY THAT TOKEN, FOLLOWED BY A ZERO (OOH) INDICATING 
THE END OF THE ASCII, FOLLOWED BY THE NEXT TOKEN. 

3) THE TABLE IS TERMINATED WITH THE CHARACTER OFFH. 

EXAMPLE: 


ORO 

2078H 


i 

MOV 

RET 

; 

ORG 

DPTR, #USER 

.TABLE 

2200H 

iTHIS DOES NOT NEED TO BE 

1 

USER_TABLE: 


jIN THIS LOCATION 

DB 

lOH 

1 FIRST TOKEN 

DB 

'DISPLAY' 

)USER KEYNORD 

DB 

OOH 

iKEYWORD TERMINATOR 

DB 

IIH 

JSECOND TOKEN 

DB 

'TRANSFER' 

iSECOND USER KEYWORD 

DB 

OOH 

iKEYWORD TERMINATOR 

1 

DB 

12H 

jTHIRD TOKEN (UP TO 16) 

DB 

'ROTATE' 

jTHIRD USER KEYWORD 

DB 

OFFH 

lEND OF USER TABLE 


This same user table is used when MCS BASIC-52 “de-tokenizes” a line during a LIST. 
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STEP 4 

Step 3 tokenizes the user keyword, this means that MCS BASIC-52 translates the user keyword into the 
user token. So, in the preceding example, the keyword TRANSFER would be replaced with the token 
IIH. When MCS BASIC-52 attempts to execute the user token, it first makes sure that the user expansion 
option BIT is set (BIT 45), then CALLS location 2070H to get the address of the user vector table. This 
address is placed in the DPTR. The user vector table consist of series of Data Words that define the address 
of the user assembly language routines. 

EXAMPLE: 


ORG 

2070H 

>LOCATION BASIC CALLS TO 

jget user lookup 

t 

MOV 

DPTR,#VECTOR 

TABLE 

RET 

/ 

VECTOR_TABLE: 

t 

DM 

RUN_DISPLAY 

I ADDRESS OF DISPLAY 

1 ROUTINE, TOKEN (lOH) 

DM 

RUN^TRANSFER 

1 ADDRESS OF TRANSFER 

1 ROUTINE, TOKEN (IIH) 

DM 

i 

ORG 

RUN^ROTATE 

1 ADDRESS OF ROTATE 

JROUTINE, TOKEN (12H) 

2300H 

1 AGAIN, THESE ROUTINES 
iMAY BE PLACED ANYMHERE 

RUN_DISPLAY: 

) USER 

ASM CODE FOR 

DISPLAY GOES HERE 

RUN_TRANSFER: 

i USER 

ASM CODE FOR 

TRANSFER GOES HERE 

RUN^ROTATE: 

t 

jUSER 

i 

ASM CODE FOR ROTATE GOES HERE 
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Note that the ordinal position of the DATA WORDS in the user vector table must correspond to the token, 
so the user statement with the token lOH must be the first DW entry in the vector table, 1IH, the second, 
12H, the third, and so on. The order of the tokens in the user table is not important!! The following user 
lookup table would function properly with the previous example: 

EXAMPLE: 


f 

USER_TABLE: 

1 

be 




13H 

jthe tokens do not 

HAVE 

DB 

'ROTATE' 

I TO BE IN ORDER IN 

THE 

DB 

f 

DB 

OOH 

juser lookup table 


iOH 



DB 

'DISPLAY' 



DB 

OOH 



DB 

12H 



DB 

'TRANSFER ' 



DB 

OFFH 

lEND OF TABLE 
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The user may also use the command/statement extension option to re-define the syntax of MCS BASIC- 
52. This is done simply by placing your own syntax in the user table and placing the appropriate BASIC 
token in front of your re-defined keyword. A complete listing of all MCS BASIC-52 tokens and keywords 
are provided in the back of this chapter. MCS BASIC-52 will always list out the program using the user 
defined systax, but it will still accept the standard keyword as a valid instruction. As an example, suppose 
that the user would like to substitute the keyword HEXOUT for PHI., then the user would generate the 
following entry in the user table: 

EXAMPLE; 


USER_TABLE: 

i 

DB 

BFH 

;TOKEN FOR PHI. 

DB 

'HEXOUT' 

iTO BE IN ORDER IN THE 

DB 

i 

DB 

OOH 

juser lookup table 

lOH 


DB 

'DISPLAY' 


DB 

I 

1 

OOH 


REST OF USER. 

..TABLE 

DB 

OFFH 

lEND OF TABLE 


MCS BASIC-52 will now accept the keyword HEXOUT and it will function in a manner identical to PHI. 
PHI. will still function correctly, however HEXOUT will be displayed when the user LIST a program. 
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TOKEN 

KEYWORD 

TOKEN 

KEYWORD 

TOKEN 

KEYWORD 

80H 

LET 

OBOH 

ABS 

OECH 

<* 

81H 

CLEAR 

OBIH 

I NT 

OEDH 

O 

82H 

PUSH 

0B2H 

SGN 

OEEH 

< 

83H 

GOTO 

0B3H 

NOT 

OEFH 

> 

84H 

PWM 

0B4H 

COS 

OFOH 

RUN 

85H 

PHO. 

0B5H 

TAN 

OFIH 

LIST 

86H 

UI 

0B6H 

SIN 

0F2H 

NULL 

87H 

UO 

0B7H 

SQR 

0F3H 

NEW 

88H 

POP 

0B8H 

CBY 

0F4H 

CONT 

89H 

PRINT 

0B9H 

EXP 

0F5H 

PROG 

89H 

P. 

OBAH 

ATN 

0F6H 

XFER 

89H 

? <V1. 1 ONLY) 

OBBH 

LOG 

0F7H 

RAM 

8AH 

CALL 

OBCH 

DBY 

0F8H 

ROM 

8BH 

DIM 

OBDH 

XBY 

0F9H 

FPROG 

8CH 

STRING 

OBEH 

PI 

OFAH-OFFH 

NOT USED 

8DH 

BAUD 

OBFH 

RND 



8EH 

CLOCK 

OCOH 

GET 



8PH 

PHI. 

OCIH 

FREE 



90H 

STOP 

0C2H 

LEN 



91H 

ONTIME 

0C3H 

XTAL 



92H 

ONEXl 

0C4H 

MTOP 



93H 

RET I 

OC5H 

TIME 



94H 

DO 

0C6H 

IE 



95H 

RESTORE 

0C7H 

IP 



96H 

REM 

0C8H 

TIMERO 



97H 

NEXT 

0C9H 

TIMER1 



98H 

ONERR 

OCAH 

TIMER2 



99H 

ON 

OCBH 

T2C0N 



9AH 

INPUT 

OCCH 

TCON 



9BH 

READ 

OCDH 

TMOD 



9CH 

DATA 

OCEH 

RCAP2 



9DH 

RETURN 

OCFH 

PORTl 



9EH 

IF 

ODOH 

PCON 



9FH 

GOSUB 

ODIH 

ASC( 



OAOH 

FOR 

0D2H 

USINO( 



OAIH 

WHILE 

0D2H 

U. ( 



0A2H 

UNTIL 

0D3H 

CHR( 



0A3H 

END 

OD4H-ODFH 

NOT USED 



OA4H 

TAB 

OEOH 

( 



OA5H 

THEN 

OElH-» 




0A6H 

TO 

0E2H 

* 



0A7H 

STEP 

0E3H 

4- 



0A8H 

ELSE 

0E4H 

/ 



0A9H 

SPC 

0E5H 




OAAH 

CR 

0E6H 

. XOR. 



OABH 

IDLE 

OE7H 

. AND. 



OACH 

ST® (VI. I ONLY) 

0E8H 

. OR. 



OADH 

LD« (VI. 1 ONLY) 

0E9H 

- (NEGATE) 



OAEH 

PGM (VI. 1 ONLY) 

OEAH 

« 



OAFH 

RROM(Vl. 1 ONLY) 

OEBH 
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CHAPTER 13 

Mapping User Code Memory 



You might have noticed by now that some of external CODE memory locations that MCS BASIC-52 calls 
and uses are located around 2000H and some of the locations are located around 4000H. Specifically, they 
are as follows: 


LOCATION FUNCTION 

2001H ON RESET, MCS BASIC-52 LOOKS FOR A OAAH IN THIS LOCATION, IF 

PRESENT, CALLS LOCATION 2090H 

2002H MCS BASIC-52 EXAMINES THIS LOCATION TO SEE IF THE USER 

WANTS TO IMPLEMENT THE COMMAND/STATEMENT EXTENSION OP¬ 
TION, A 05AH IS TO BE PLACED IN THIS LOCATION TO EVOKE THE 
COMMAND/EXTENSION OPTION 

2048H MCS BASIC-52 CALLS THE LOCATION IF THE USER WANTS TO IMPLE¬ 

MENT THE COMMAND/STATEMENT EXTENSION OPTION. THE USER 
WILL USUALLY SET BIT 45 THEN RETURN. 

2070H MCS BASIC-52 CALLS THIS LOCATION TO GET THE USER VECTOR TA¬ 

BLE ADDRESS WHEN THE COMMAND/STATEMENT EXTENSION OP¬ 
TION IS EVOKED. THE ADDRESS OF THE VECTOR TABLE IS PUT IN 
THE DPTR BY THE USER. 

2078H MCS BASIC-52 CALLS THIS LOCATION TO GET THE USER LOOKUP TA¬ 

BLE ADDRESS WHEN THE COMMAND/STATEMENT EXTENSION OP¬ 
TION IS EVOKED. THE ADDRESS OF THE LOOKUP TABLE IS PUT IN 
THE DPTR BY THE USER. 

2090H MCS BASIC-52 CALLS THIS LOCATION WHEN THE USER EVOKES THE 

ASSEMBLY LANGUAGE RESET OPTION 

4003H EXTERNAL INTERRUPT 0 

400BH TIMER O INTERRUPT 

4013H EXTERNAL INTERRUPT 1 

401BH TIMER 0 INTERRUPT 

4023H SERIAL PORT INTERRUPT 

402BH TIMER 2 INTERRUPT 

4030H USER CONSOLE OUTPUT 

4033H USER CONSOLE INPUT 

4036H USER CONSOLE STATUS 

403CH USER PRINT® OR LIST® VECTOR 

41OOH-41FFH USER CALLS FORM 0 TO 7FH 
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MAPPING USER CODE MEMORY 

Other vectors between 2040H and 2090H also exist, but they are mainly for testing purposes, but for your 
information they are: 

LOCATION FUNCTION 

2040H TRAP LOCATION FOR EXTERNAL INTERRUPT 0 IF BIT 26H OF INTER¬ 

NAL RAM IS SET AND THE DMA OPTION IS EVOKED. PSW IS NOT 
PUSHED ONTO STACK. INTERRUPTS OF COURSE, MUST BE ENA¬ 
BLED. ALSO, THIS LOCATION WILL BE CALLED FOR CONSOLE OUT¬ 
PUT IF BIT 2CH OF INTERNAL RAM IS SET. 

2050H TRAP LOCATION FOR SERIAL PORT INTERRUPT IF BIT 1FH OF INTER¬ 

NAL RAM IS SET. PSW IS PUSHED ONTO THE STACK. 

2060H CALLED FOR CONSOLE INPUT IF BIT 32H OF INTERNAL RAM IS SET. 

2068H CALLED FOR CONSOLE STATUS CHECK IF BIT 32H OF INTERNAL RAM 

IS SET. 

2088H TIMER 1 INTERRUPT TRAP IF BIT 1AH OF INTERNAL RAM IS SET. PSW 

IS PUSHED ONTO THE STACK. 

Contrary to popular belief, these vectors were not chosen to force the user to buy bigger EPROMS. They 
are chosen so that addresses 2000H and 4000H can be overlayed and create no conflicts. The Overlayed 
addresses would appear as 2001H, 2002H, 4003H, 400BH, 4013H, 401BH, 4023H, 402BH, 4030H, 
4033H, 4036H, 4039H, 2040H, 2048H, 2050H, 2060H, 2068H, 2070H, 2078H, 2088H, 2090H, and 
4100H thru 41FFH. The diagram on the next page illustrates how to implement overlapping addresses for 
2000H and 4000H. By using overlapping addresses, the user can implement all MCS BASIC-52 user 
expansion options with only a few hundred bytes of EPROM. 

The reason this type of addressing scheme was chosen is that it permits the designer to offer custom 
versions of MCS BASIC-52, by using the vector locations in the 2000H region. And give the designers 
OEM the ability to take advantage of the I/O vectors located in the 4000H region. 

As an added note, the MCS-51 instruction set is object relocatable on 2K boundaries if no LCALL or 
LIMP instructions are used. This means that it is possible for the designer to ORG a program for 2000H 
and actually execute the program at 2800H, 3000H, 3800H, etc. If the user does not use the LCALL or 
LJMP instructions. 
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1.1 MEMORY USAGE (Version 1.0) 

The following list specifies what locations in internal and external memory MCS BASIC-52 uses, and 
what these locations are used for. This information can largely be regarded as “for your information,” 
but it can be used to do things like alter the pulse width of a EPROM programming pulse, etc. 


INTERNAL MEMORY ALLOCATION: 


LOCATION(S) IN HEX MCS BASIC-52 USAGE 


OOH THRU 07H 

OSH 

09H 

OAH 

OBH THRU OFH 

10H 

11H 

12H 

13H 

14H 

15H 

16H 

17H 

18H THRU 21H 


“WORKING REGISTER BANK” 

BASIC TEXT POINTER — LOW BYTE 

ARGUMENT STACK POINTER 

BASIC TEXT POINTER — HIGH BYTE 

TEMPORARY BASIC STORAGE 

READ TEXT POINTER — LOW BYTE 

CONTROL STACK POINTER 

READ TEXT POINTER — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — LOW BYTE 

NULL COUNT 

PRINT HEAD POSITION FOR OUTPUT 
FLOATING POINT OUTPUT FORMAT TYPE 
NOT USED — RESERVED FOR USER 


22H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 22.0H 

SET WHEN 

BIT22.1H 

SET WHEN 

BIT 22.2H 

SET WHEN 

BIT 22.3H 

SET WHEN 

BIT 22.4H 

SET WHEN 

BIT 22.5H 

SET WHEN 

BIT 22.6H 

SET WHEN 

BIT 22.7H 

WHEN SET 


“ONTIME” STATEMENT IS EXECUTED 
BASIC INTERRUPT IN PROGRESS 
“ONEX1” STATEMENT IS EXECUTED 
“ONERR” STATEMENT IS EXECUTED 
“ONTIME” INTERRUPT IS IN PROGRESS 
A LINE IS EDITED 

EXTERNAL INTERRUPT IS PENDING 
, CONT COMMAND WILL WORK 


23H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 23.0H 
BIT 23.1 H 
BIT 23.2H 
BIT 23.3H 
BIT 23.4H 
BIT23.5H 
BIT 23.6H 
BIT 23.7H 


USED AS FLAG FOR “GET” OPERATOR 

SET WHEN INVALID INTEGER FOUND IN TEXT 

TEMPORARY BIT LOCATION 

CONSOLE OUTPUT CONTROL, 1 =LINE PRINTER 

CONSOLE OUTPUT CONTROL, 1 = USER DEFINED 

BASIC ARRAY INITIALIZATION BIT 

CONSOLE INPUT CONTROL, 1 = USER DEFINED 

RESERVED 
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INTERNAL MEMORY ALLOCATION: 

LOCATION(S) IN HEX MCS BASIC-52 USAGE 

24H BITS USED SPECIFICALLY AS FOLLOWS 


BIT 24.0H 
BIT24.1H 
BIT 24.2H 
BIT 24.3H 
BIT 24.4H 
BIT 24.5H 
BIT 24.6H 
BIT 24.7H 


STOP STATEMENT OR CONTROL-C ENCOUNTERED 

0 = HEX INPUT, 1 = FP INPUT 

0 = RAM MODE, 1 = ROM MODE 

ZERO FLAG FOR DOUBLE BYTE COMPARE 

SET WHEN ARGUMENT STACK HAS A VALUE 

RETI INSTRUCTION EXECUTED 

RESERVED 

RESERVED 


25H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 25.0H 
BIT 25.1H 
BIT 25.2H 
BIT 25.3H 
BIT 25.4H 
BIT 25.5H 
BIT 25.6H 
BIT 25.7H 


RESERVED, SOFTWARE TRAP TEST 
FIND THE END OF PROGRAM, IF SET 
RESERVED 

INTERRUPT STATUS SAVE BIT 

SET WHEN PROGRAM EXECUTION IS COMPLETE 

RESERVED, EXTERNAL TRAP TEST 

SET WHEN CLOCK1 EXECUTED, ELSE CLEARED 

SET WHEN BASIC IS IN THE COMMAND MODE 


26H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 26.0H 
BIT 26.1 H 
BIT 26.2H 
BIT 26.3H 
BIT 26.4H 
BIT 26.5H 
BIT 26.6H 
BIT 26.7H 


SET TO DISABLE CONTROL-C 
SET TO ENABLE “FAKE” DMA 
RESERVED 

SET TO EVOKE “INTELLIGENT” PROM PROGRAMMING 
SET TO PRINT TEXT STRING FROM ROM 
RESERVED 

SET TO SUPPRESS ZEROS IN HEX MODE PRINT 
SET TO EVOKE HEX MODE PRINT 
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INTERNAL MEMORY ALLOCATION: 


LOCATION(S) IN HEX MCS BASIC-52 USAGE 


27H 

28H THRU 3DH 

3EH 

3FH 

40H 

41H 

42H 

43H 

44H 

45H 

46H 

47H 

48H 

49H 

4AH 

4BH 

4CH 

4DH THRU OFFH 


“BIT” ADDRESSABLE BYTE COUNTER 
BIT AND BYTE FLOATING POINT WORKING SPACE 
INTERNAL STACK POINTER HOLDING REGISTER 
LENGTH OF USER DEFINED STRING — $ 

TIMER 1 RELOAD LOCATION — HIGH BYTE 
TIMER 1 RELOAD LOCATION — LOW BYTE 
BASIC TEXT POINTER SAVE LOCATION — HIGH BYTE 
BASIC TEXT POINTER SAVE LOCATION — LOW BYTE 
RESERVED 

TRANSCENDENTAL FUNCTION TEMP STORAGE 
TRANSCENDENTAL FUNCTION TEMP STORAGE 
MILLI-SECOND COUNTER FOR REAL TIME CLOCK 
SECOND COUNTER FOR REAL TIME CLOCK — HIGH 
BYTE 

SECOND COUNTER FOR REAL TIME CLOCK — LOW 
BYTE 

TIMER 0 RELOAD FOR REAL TIME CLOCK 
SOFTWARE SERIAL PORT BAUD RATE — HIGH BYTE 
SOFTWARE SERIAL PORT BAUD RATE — LOW BYTE 
8052AH STACK SPACE AND USER WORKING SPACE 
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1.1 MEMORY USAGE 


EXTERNAL MEMORY ALLOCATION 


LOCATION(S) IN HEX MCS BASIC-52 USAGE 


OOH AND 01H 
02H AND OSH 
04H 

OSH AND 06H 

07H THRU 49H 

50HTHRU5FH 

60H THRU OFEH 

OFFH 

100H 

101H 

102H AND 103H 
104H AND 105H 
106H AND 107H 
108H AND 109H 
10AH AND 10BH 
10CH AND 10DH 
10EH THRU 113H 
114H THRU 11FH 
120H AND 121H 
122H AND 123H 
124H THRU 127H 
128H AND 129H 
12AH AND 12BH 
12CH 

12DH THRU 1FEH 


“LAST” END OF FILE ADDRESS FOR RAM FILE (H-L) 

CURRENT END OR FILE ADDRESS FOR RAM FILE (H-L) 

LENGTH OF THE CURRENT EDITED LINE 

LN NUM IN BINARY OF CURRENT EDITED LINE (H-L) 

BASIC INPUT BUFFER 

FLOATING POINT OUTPUT TEMP 

CONTROL STACK 

CONTROL STACK OVERFLOW 

LOCATION TO SAVE “GET” CHARACTER 

LOCATION TO SAVE ERROR CHARACTER CODE 

LOCATION TO GO TO ON USER “ONERR” (H-L) 

TOP OF VARIABLE STORAGE (H-L) 

FP STORAGE ALLOCATION (H-L) 

MEMORY ALLOCATED FOR MATRICES (H-L) 

TOP OF MEMORY ASSIGNED TO BASIC (H-L) 

RANDOM NUMBER SEED (H-L) 

CRYSTAL VALUE 
FLOATING POINT TEMPS 

LOCATION TO GO TO ON ONEX1 INTERRUPT (H-L) 
NUMBER OF BYTES ALLOCATED FOR STRINGS (H-L) 
ONTIME INTERRUPT AND LINE NUMBER (H-L) 
“NORMAL” PROM PROGRAMMER TIME OUT (H-L) 
“INTELLIGENT” PROM PROGRAMMER TIME OUT (H-L) 
RESERVED 
ARGUMENT STACK 


NOTE: (H-L) means HIGH BYTE — LOW BYTE, in external memory all 16 bit binary numbers 
are stored with the HIGH BYTE in the first (lower order) address and the LOW BYTE in the 
next sequential address. 
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1.1 MEMORY USAGE (VERSION 1.1) 

The following list specifies what locations in internal and external memory locations are used by Version 
1.1 of MCS BASIC-52. Any differences between Vl.O and Vl.l are in bold face type. 


INTERNAL MEMORY ALLOCATION: (VERSION 1.1) 


LOCATION(S) IN HEX MCS BASIC-52 USAGE 


OOH THRU 07H 

OSH 

09H 

OAH 

OBH THRU OFH 

10H 

11H 

12H 

13H 

14H 

15H 

16H 

17H 

18H THRU 21H 


“WORKING REGISTER BANK” 

BASIC TEXT POINTER — LOW BYTE 

ARGUMENT STACK POINTER 

BASIC TEXT POINTER — HIGH BYTE 

TEMPORARY BASIC STORAGE (Available to user in BASIC 

CALLS to ASM routines) 

READ TEXT POINTER — LOW BYTE 

CONTROL STACK POINTER 

READ TEXT POINTER — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — HIGH BYTE 

START ADDRESS OF BASIC PROGRAM — LOW BYTE 

NULL COUNT 

PRINT HEAD POSITION FOR OUTPUT 
FLOATING POINT OUTPUT FORMAT TYPE 
NOT USED — RESERVED FOR USER 


22H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 22.0H 

SET WHEN 

BIT 22.1 H 

SET WHEN 

BIT 22.2H 

SET WHEN 

BIT 22.3H 

SET WHEN 

BIT 22.4H 

SET WHEN 

BIT 22.5H 

SET WHEN 

BIT 22.6H 

SET WHEN 

BIT 22.7H 

WHEN SET 


“ONTIME” STATEMENT IS EXECUTED 
BASIC INTERRUPT IN PROGRESS 
“ONEX1” STATEMENT IS EXECUTED 
“ONERR” STATEMENT IS EXECUTED 
“ONTIME” INTERRUPT IS IN PROGRESS 
A LINE IS EDITED 

EXTERNAL INTERRUPT IS PENDING 
, CONT COMMAND WILL WORK 


23H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 23.0H 
BIT 23.1 H 
BIT 23.2H 
BIT 23.3H 
BIT 23.4H 
BIT 23.5H 
BIT 23.6H 
BIT 23.7H 


USED AS FLAG FOR “GET” OPERATOR 
SET WHEN PRINT® OR LIST® IS EVOKED 
RESERVED, TRAPS TIMER 1 INTERRUPT 
CONSOLE OUTPUT CONTROL, 1 = LINE PRINTER 
CONSOLE OUTPUT CONTROL, 1 = USER DEFINED 
BASIC ARRAY INITIALIZATION BIT 
CONSOLE INPUT CONTROL, 1 = USER DEFINED 
RESERVED, US^D TO TRAP SERIAL PORT INTERRUPT 
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INTERNAL MEMORY ALLOCATION (VERSION 1.1) 

LOCATION(S) IN HEX MCS BASIC-52 USAGE 


24H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 24.0H 

BIT 24.1 H 
BIT 24.2H 
BIT 24.3H 
BIT 24.4H 
BIT 24.5H 
BIT 24.6H 
BIT 24.7H 


STOP STATEMENT OR CONTROL-C ENCOUNTERED 

USER IDLE BREAK BIT 

SET DURING AN INPUT INSTRUCTION 

RESERVED 

SET WHEN ARGUMENT STACK HAS A VALUE 
RETI INSTRUCTION EXECUTED 

RESERVED, TRAPS EXTERNAL INTERRUPT 0 
SET BY USER TO SIGNIFY THAT A VALID LIST® OR 
PRINT® DRIVER IS PRESENT 


25H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 25.0H 
BIT 25.1 H 
BIT 25.2H 
BIT 25.3H 
BIT 25.4H 
BIT 25.5H 
BIT 25.6H 
BIT 25.7H 


RESERVED, SOFTWARE TRAP TEST 

FIND THE END OF PROGRAM, IF SET 

SET DURING A DIM STATEMENT 

INTERRUPT STATUS SAVE BIT 

RESERVED, INPUT TRAP 

SET TO SIGNIFY EXPANSION IS PRESENT 

SET WHEN CLOCK1 EXECUTED, ELSE CLEARED 

SET WHEN BASIC IS IN THE COMMAND MODE 


26H 


BITS USED SPECIFICALLY AS FOLLOWS 


BIT 26.0H 
BIT 26.1H 
BIT 26.2H 
BIT 26.3H 
BIT 26.4H 
BIT 26.5H 
BIT 26.6H 
BIT 26.7H 


SET TO DISABLE CONTROL-C 
SET TO ENABLE “FAKE” DMA 

RESERVED, OUTPUT TRAP 

SET TO EVOKE “INTELLIGENT” PROM PROGRAMMING 
SET TO PRINT TEXT STRING FROM ROM 
SET WHEN CONTROL'S ENCOUNTERED 
SET TO SUPPRESS ZEROS IN HEX MODE PRINT 
SET EVOKE HEX MODE PRINT 
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INTERNAL MEMORY ALLOCATION (VERSION 1.1) 


LOCATION(S) IN HEX MCS BASIC-52 USAGE 


27H 

28H THRU 3DH 

3EH 

3FH 

40H 

41H 

42H 

43H 

44H 

45H 

46H 

47H 

48H 

49H 

4AH 

4BH 

4CH 

4DH THRU OFFH 


“BIT” ADDRESSABLE BYTE COUNTER 
BIT AND BYTE FLOATING POINT WORKING SPACE 
INTERNAL STACK POINTER HOLDING REGISTER 
LENGTH OF USER DEFINED STRING — $ 

TIMER 1 RELOAD LOCATION — HIGH BYTE 
TIMER 1 RELOAD LOCATION — LOW BYTE 
BASIC TEXT POINTER SAVE LOCATION — HIGH BYTE 
BASIC TEXT POINTER SAVE LOCATION — LOW BYTE 
RESERVED 

TRANCENDENTAL FUNCTION TEMP STORAGE 
TRANCENDENTAL FUNCTION TEMP STORAGE 
MILLI-SECOND COUNTER FOR REAL TIME CLOCK 
SECOND COUNTER FOR REAL TIME CLOCK — HIGH 
BYTE 

SECOND COUNTER FOR REAL TIME CLOCK — LOW 
BYTE 

TIMER 0 RELOAD FOR REAL TIME CLOCK 

USER ARGUMENT FOR ONTIME — HIGH BYTE 
USER ARGUMENT FOR ONTIME — LOW BYTE 

8052AH STACK SPACE AND USER WORKING SPACE 
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EXTERNAL MEMORY ALLOCATION (VERSION 1.1) 


LOCATION(S) IN HEX MCS BASIC-52 USAGE 


OOH THRU OSH 

04H 

OSH AND 06H 

07H THRU 56H 
56H THRU 5DH 
5EH 
5FH 

60H THRU OFEH 

OOFH 

100H 

101H 

102H AND 103H 
104H AND 105H 
106H AND 107H 
108H AND 109H 
10AH AND 10BH 
10CH AND 10DH 
10EH THRU 113H 
114H THRU 11FH 
120H AND 121H 
122H AND 123H 
124H AND 125H 
126H AND 127H 
128H AND 129H 
12AH AND 12BH 
12CH 

12DH THRU 1FEH 


NOT USED, RESERVED 

LENGTH OF THE CURRENT EDITED LINE 

LN NUM IN BINARY OF CURRENT EDITED LINE (H-L) 

BASIC INPUT BUFFER 

BINARY TO INTEGER TEMP 

USED FOR RUN TRAP MODE (= 34H) 

USED FOR POWER-UP TRAP (= 0A5H) 

CONTROL STACK 
CONTROL STACK OVERFLOW 
LOCATION TO SAVE “GET” CHARACTER 
LOCATION TO SAVE ERROR CHARACTER CODE 
LOCATION TO GO TO ON USER “ONERR” (H-L) 

TOP OF VARIABLE STORAGE (H-L) 

FP STORAGE ALLOCATION (H-L) 

MEMORY ALLOCATED FOR MATRICES (H-L) 

TOP OF MEMORY ASSIGNED TO BASIC (H-L) 

RANDOM NUMBER SEED (H-L) 

CRYSTAL VALUE 
FLOATING POINT TEMPS 

LOCATION TO GO TO ON ONEX1 INTERRUPT (H-L) 
NUMBER OF BYTES ALLOCATED FOR STRINGS (H-L) 
SOFTWARE SERIAL PORT BAUD RATE (H-L) 

LINE NUMBER FOR ONTIME INTERRUPT (H-L) 
“NORMAL” PROM PROGRAMMER TIME OUT (H-L) 
“INTELLIGENT” PROM PROGRAMMER TIME OUT (H-L) 
RESERVED 
ARGUMENT STACK 


NOTE: (H-L) still means HIGH BYTE — LOW BYTE, in external memory all 16 bit binary numbers 
are stored with the HIGH BYTE in the first (lower order) address and the LOW BYTE in the next sequential 
address. 
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1.2 USING THE PWM STATEMENT 

The PWM statement can be used to generate quite accurate frequencies. The following table lists the reload 
values 8 octaves of an equal tempered chromatic scale. The reload values are for the first two arguments 
of the PWM statement, so it is assumed that a square wave is being generated. The reload values assume 


a 11.0592 

MHz crystal. 







IDEAL 

ACTUAL 


HEX 

NOTE 

OCTAVE 

FREQUENCY 

FREQUENCY 

RELOAD 

RELOAD 

C 

1 

32.703 

32.704 

14090 

370AH 

c# 

1 

34.648 

34.649 

13299 

33F3H 

D 

1 

36.708 

36.708 

12553 

3109H 

D# 

1 

38.891 

38.889 

11849 

2E49H 

E 

1 

41.203 

41.202 

11184 

2BB0H 

F 

1 

43.654 

43.653 

10556 

293CH 

F# 

1 

46.246 

46.215 

9963 

26EBH 

G 

1 

48.999 

49.000 

9404 

24BCH 

G# 

1 

51.913 

51.915 

8876 

22ACH 

A 

1 

55.000 

55.001 

8378 

20BAH 

A# 

1 

58.270 

58.270 

7908 

1EE4H 

B 

1 

61.735 

61.736 

7464 

1D28H 

C 

2 

65.406 

65.408 

7045 

1B85H 

C# 

2 

69.296 

69.293 

6650 

19FAH 

D 

2 

73.416 

73.411 

6277 

1885H 

D# 

2 

77.782 

77.785 

5924 

1724H 

E 

2 

82.406 

82.403 

5592 

15D8H 

F 

2 

87.308 

87.306 

5278 

149EH 

F# 

2 

92.498 

92.493 

4982 

1376H 

G 

2 

97.998 

98.000 

4702 

125EH 

G# 

2 

103.826 

103.830 

4438 

1156H 

A 

2 

110.000 

110.002 

4189 

105DH 

A# 

2 

116.540 

116.540 

3954 

0F72H 

B 

2 

123.470 

123.472 

3732 

0E94H 

C 

3 

130.812 

130.798 

3523 

0DC3H 

C# 

3 

138.592 

138.586 

3325 

OCFDH 

D 

3 

146.832 

146.845 

3138 

0C42H 

D# 

3 

155.564 

155.570 

2962 

0B92H 

E 

3 

164.812 

164.807 

2796 

OAECH 

F 

3 

174.616 

174.612 

2639 

0A4FH 

F# 

3 

184.996 

184.986 

2491 

09BBH 

G 

3 

195.996 

196.001 

2351 

092FH 

G# 

3 

207.652 

207.661 

2219 

08ABH 

A 

3 

220.000 

219.952 

2095 

082FH 

A# 

3 

233.080 

233.080 

1977 

07B9H 

B 

3 

246.940 

246.946 

1866 

074AH 
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1.2 USING THE PWM STATEMENT 




IDEAL 

ACTUAL 


HEX 

NOTE 

OCTAVE 

FREQUENCY 

FREQUENCY 

RELOAD 

RELOAD 

C 

4 

261.624 

261.669 

1761 

06E1H 

c# 

4 

277.184 

277.256 

1662 

067EH 

D 

4 

293.664 

293.690 

1569 

0621H 

D# 

4 

311.128 

311.141 

1481 

05C9H 

E 

4 

329.624 

329.614 

1398 

0576H 

F 

4 

349.232 

349.355 

1319 

0527H 

F# 

4 

369.992 

370.120 

1245 

04DDH 

G 

4 

391.992 

391.836 

1176 

0498H 

G# 

4 

415.304 

415.135 

1110 

0456H 

A 

4 

440.000 

440.114 

1047 

0417H 

A# 

4 

466.160 

465.925 

989 

03DDH 

B 

4 

493.880 

493.890 

933 

03A5H 

C 

5 

523.248 

523.042 

881 

0371H 

C# 

5 

554.368 

554.512 

831 

033FH 

D 

5 

587.238 

587.006 

785 

0311H 

D# 

5 

622.256 

621.862 

741 

02E5H 

E 

5 

659.248 

659.228 

699 

02BBH 

F 

5 

698.464 

698.182 

660 

0294H 

F# 

5 

739.984 

739.647 

623 

026FH 

G 

5 

783.984 

783.674 

588 

024CH 

G# 

5 

830.608 

830.270 

555 

022BH 

A 

5 

880.000 

879.389 

524 

020CH 

A# 

5 

932.320 

932.793 

494 

01EEH 

B 

5 

987.760 

986.724 

467 

01D3H 

C 

6 

1046.496 

1047.272 

440 

01B8H 

C# 

6 

1108.736 

1107.692 

416 

01A0H 

D 

6 

1174.656 

1175.510 

392 

0188H 

D# 

6 

1244.512 

1245.405 

370 

0172H 

E 

6 

1318.496 

1320.343 

349 

015DH 

F 

6 

1396.928 

1396.364 

330 

014AH 

F# 

6 

1479.968 

1481.672 

311 

0137H 

G 

6 

1567.968 

1567.347 

294 

0126H 

G# 

6 

1661.216 

1663.538 

277 

0115H 

A 

6 

1760.000 

1758.779 

262 

0106H 

A# 

6 

1864.640 

1865.587 

247 

00F7H 

B 

6 

1975.520 

1977.682 

233 

00E9H 


171 




MCS® BASIC-52 


inter 


1.2 USING THE PWM STATEMENT 


NOTE 

OCTAVE 

IDEAL 

FREQUENCY 

ACTUAL 

FREQUENCY 

RELOAD 

HEX 

RELOAD 

C 

7 

2092.992 

2094.545 

220 

OODCH 

c# 

7 

2217.472 

2215.385 

208 

OODOH 

D 

7 

2349.312 

2351.020 

196 

00C4H 

D# 

7 

2489.024 

2490.811 

185 

00B9H 

E 

7 

2636.992 

2633.143 

175 

OOAFH 

F 

7 

2793.856 

2792.727 

165 

00A5H 

F# 

7 

2959.936 

2953.846 

156 

009CH 

G 

7 

3135.936 

3134.694 

147 

0093H 

G# 

7 

3322.432 

3315.108 

139 

008BH 

A 

7 

3520.000 

3517.557 

131 

0083H 

A# 

7 

3729.280 

3716.129 

124 

007CH 

B 

7 

3951.040 

3938.362 

117 

0075H 

C 

8 

4185.984 

4189.091 

110 

006EH 

C# 

8 

4434.944 

4430.770 

104 

0068H 

D 

8 

4698.624 

4702.041 

98 

0062H 

D# 

8 

4987.048 

5008.695 

92 

005CH 

E 

8 

5273.984 

5296.552 

87 

0057H 

F 

8 

5587.712 

5619.512 

82 

0052H 

F# 

8 

5919.872 

5907.692 

78 

004EH 

G 

8 

6217.872 

6227.027 

74 

004AH 

G# 

8 

6644.864 

6678.261 

69 

0045H 

A 

8 

7040.000 

7089.231 

65 

0041H 

A# 

8 

7458.560 

7432.258 

62 

003EH 

B 

8 

7902.080 

7944.827 

58 

003AH 
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1.2 USING THE PWM STATEMENT 

The following program generates the appropriate reload values for the PWM statement, using any crystal. 
The user enters the desired frequency and the crystal and the program determined the reload values and 
errors. 


>10 INPUT "ENTER CRYSTAL FREQUENCY - ", X 
>20 T=12/X 

>30 INPUT "ENTER DESIRED FREQUENCY FOR PWM - ", F 
>40 Fl=l/F 

>50 C*<Fl/T)/2 : REM CALCULATE RELOAD VALUE 
>60 IF C<20 THEN 30 

>70 C1=C-INT(C) : REM CALCULATE FRACTION 
>80 IF CIC. 5 THEN 90 ; C=C-M 

>90 PRINT : PRINT "THE DESIRED FREQUENCY IS - ",X,"HZ" 

>100 C=INT<C) : PRINT 

>110 PRINT "THE ACTUAL FREQUENCY IS - ", 1/(2*C*T), "HZ" 

>120 PRINT 

>130 PRINT "THE RELOAD VALUE FOR PWM IS - ",C," IN HEX - : PHl.C 

>140 INPUT "ANOTHER FREQUENCY, 1=YES, 0=N0 « ",Q 
>150 IF 0=1 THEN 20 


173 






MCS® BASIC-52 


1.3 BAUD RATES AND CRYSTALS 


The 16 bit auto-reload timer/counter (TIMER2) that is used to generate baud rates for the MCS BASIC-52 
device is capable of generating accurate baud rates with a number of crystals. The following is a list of 
crystals that will accurately generate 9600 baud on the MCS BASIC-52 device. Additionally, the crystal 
values on the left hand side of the table will accurately generate 19200 baud. 


XTAL 

RCAP2 RELOAD 

XTAL 

RCAP2 RELOAD 

3680400 

65524 

3993600 

65523 

4300800 

65522 

4608000 

65521 

4915200 

65520 

5222400 

65519 

5529600 

65518 

5836800 

65517 

6144000 

65516 

6451200 

65515 

6758400 

65514 

7065600 

65513 

7372800 

65512 

7680000 

65511 

7987200 

65510 

8294400 

65509 

8601600 

65508 

8908800 

65507 

9216000 

65506 

9523200 

65505 

9830400 

65504 

10137600 

65503 

10444800 

65502 

10752000 

65501 

11059200 

65500 

11366400 

65499 

11673600 

65498 

11980800 

65497 


With the crystals listed above, the accuracy of the baud rate generator and the REAL TIME CLOCK will 
depend ONLY on the absolute accuracy of the crystal. Note that the baud rate generator for the 8052AH 
is so accurate that any crystal above 10 MHz will generate 9600 baud to within 1.5% accuracy. 
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1.3 BAUD RATES AND CRYSTALS 


The following program generates the appropriate TIMER2 reload values for a given baud rate. The user 
supplies the system clock frequency and the desired baud rate and the program calculates the proper 
TIMER2 reload value. Additionally, percent error, for both the baud rate generator and MCS BASIC-52’s 
REAL TIME CLOCK are calculated and displayed. 


>10 I^4PUT"ENTER CRYSTAL - X 
>20 INPUT"ENTER BAUD RA^TE - ”,0 
>30 R=X/(32*B):T=X/76a00 
>40 R1=R-INT<R):T1=T-INT(T) 

>50 IF RIC. 5 THEN 80 
>60 R1=1-R1 
>70 R=R+1 

>80 IF Tl<. 5 THEN 110 
>90 T1=1-T1 
>100 T=T+1 

>110 PRINT ••TIMER2 RELOAD VALUE IS - ‘S USING(######), INT(65536-R ) 
>120 PRINT "BAUD RATE ERROR IS ~ ", USING( ##.###), (R1/R )*100. " 7 ." 
>130 PRINT "REAL TIME CLOCK ERROR IS - " (Tl/T)*100, "7." 
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1.4 QUICK REFERENCE 

COMMANDS: 


COMMAND 

FUNCTION 

EXAMPLE(S) 

RUN 

Execute a program 

RUN 

CONT 

CONTinue after a STOP or control-C 

CONT 

LIST 

LIST program to the console device 

LIST 

LIST 10-50 

LIST# 

LIST program to serial printer 

LIST# 

LIST# 50 

LIST® 

LIST program to user driver (version 1.1 
only) 

LIST® 

LIST® 50 

NEW 

erase the program stored in RAM 

NEW 

NULL 

set NULL count after carriage return¬ 
line feed 

NULL 

NULL 4 

RAM 

evoke RAM mode, current program in 
READ/WRITE memory 

RAM 

ROM 

evoke ROM mode, current program in 
ROM/EPROM memory 

ROM 

ROM 3 

XFER 

transfer a program from ROM/EPROM to 

RAM 

XFER 

PROG 

save the current program in EPROM 

PROG 

PROG1 

save baud rate information in EPRO^ 

PROG1 

PROG2 

save baud rate information in EPROM 
and execute program after RESET 

PROG2 

PROGS 

save baud rate and MTOP information in 
EPROM (version 1.1 only) 

PROG3 

PROG4 

save baud rate and MTOP information in 
EPROM and execute program after 

RESET (version 1.1 only) 

PROG4 
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1.4 QUICK REFERENCE 


COMMANDS: 

COMMAND 

FUNCTION 

EXAMPLE(S) 

PROGS 

same as PROG4 except that external 

RAM is not cleared on RESET or power 
up if external RAM contains a 0A5H in 
location 5EH (version 1.1 only) 

PROGS 

PROG6 

same as PROG6 except that external 
code location 4039H is CALLED after 

RESET (version 1.1 only) 

PROGS 

FPROG 

save the current program in EPROM 
using the INTELIigent algorithm 

FPROG 

FPROG1 

save baud rate information in EPROM 
using the INTELIigent algorithm 

FPROG 1 

FPROG2 

save baud rate information in EPROM 
and execute program after RESET, use 
INTELIigent algorithm 

FPROG2 

FPROG3 

same as PROG3, except INTELIigent 
programming algorithm is used (version 

1.1 only) 

FPROG3 

FPROG4 

same as PROG4, except INTELIigent 
programming algorithm is used (version 

1.1 only) 

FPROG4 

FPROG5 

same as PROGS, except INTELIigent 
programming algorithm is used (version 

1.1 only) 

FPROGS 

FPROG6 

same as PROGS, except INTELIigent 
programming algorithm is used (version 

1.1 only) 

FPROGS 
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1.4 QUICK REFERENCE 


STATEMENTS: 



STATEMENT 

FUNCTION 

EXAMPLE(S) 

BAUD 

set baud rate for line printer port 

BAUD 1200 

CALL 

CALL assembly language program 

CALL9000H 

CLEAR 

CLEAR variables, interrupts and Strings 

CLEAR 

CLEARS 

CLEAR Stacks 

CLEARS 

CLEARI 

CLEAR Interrupts 

CLEARI 

CL0CK1 

enable REAL TIME CLOCK 

CLOCK1 

CLOCKO 

disable REAL TIME CLOCK 

CLOCKO 

DATA 

DATA to be read by READ statement 

DATA 100 

READ 

READ data in DATA statement 

READ A 

RESTORE 

RESTORE READ pointer 

RESTORE 

DIM 

allocate memory for arrayed variables 

DIM A(20) 

DO 

set up loop for WHILE or UNTIL 

DO 

UNTIL 

test DO loop condition (loop if false) 

UNTIL A = 10 

WHILE 

test DO loop condition (loop if true) 

WHILE A=B 

END 

terminate program execution 

END 

FOR-TO-{STEP} 

set up FOR-NEXT loop 

FOR A=1 TO 5 

NEXT 

test FOR-NEXT loop condition 

NEXT A 
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1.4 QUICK REFERENCE 


STATEMENTS: 



STATEMENT 

FUNCTION 

EXAMPLE(S) 

GOSUB 

execute subroutine 

GOSUB 1000 

RETURN 

RETURN from subroutine 

RETURN 

GOTO 

GOTO program line number 

GOTO 500 

ON GOTO 

conditional GOTO 

ON A GOTO 5, 

20 

ON GOSUB 

conditional GOSUB 

ON A GOSUB 2, 

6 

IF-THEN-{ELSE} 

conditional test 

IF A<B THEN 

A = 0 

INPUT 

INPUT a string or variable 

INPUT A 

LET 

assign a variable or string a value 
(LET is optional) 

LET A=10 

ONERR 

ONERRor GOTO line number 

ONERR 1000 

ONTIME 

generate an interrupt when TIME is equal 
to or greater than ONTIME argument-line 
number is after comma 

ONTIME 10, 1000 

ONEX1 

GOSUB to line number following ONEX1 
when INTI pin is pulled low 

ONEX1 1000 

PRINT 

PRINT variables, strings or literals 

P. is shorthand for PRINT 

PRINT A 

PRINT# 

PRINT to software serial port 

PRINT# A 

PRO. 

PRINT HEX mode with zero suppression 

PHO. A 

PHI. 

PRINT HEX mode with no zero 
suppression 

PHI. A 

PRO.# 

PHO. to line printer 

PHO.# A 

PHI.# 

PHI.# to line printer 

PHI.# A 
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1.4 QUICK REFERENCE 

STATEMENTS: 


STATEMENT 

FUNCTION 

EXAMPLE(S) 

PRINT® 

PRINT to user defined driver (version 1.1 
only) 

PRINT® 5*5 

PHO.® 

PHO. to user defined driver (version 1.1 
only) 

PHO. ® 

XBY(5EH) 

PHI.® 

PHI. to user defined driver (version 1.1 
only) 

PHI.® A 

PGM 

Program an EPROM (version 1.1 only) 

PGM 

PUSH 

PUSH expressions on argument stack 

PUSH 10, A 

POP 

POP argument stack to variables 

POP A, B, C 

PWM 

PULSE WIDTH MODULATION 

PWM 50, 50, 100 

REM 

REMark 

REM DONE 

RETI 

RETurn from Interrupt 

RETI 

STOP 

break program execution 

STOP 

STRING 

allocate memory for STRINGS 

STRING 50, 10 

UI1 

evoke User console Input routine 

UI1 

UlO 

evoke BASIC console Input routine 

UlO 

U01 

evoke User console Output routine 

U01 

UOO 

evoke BASIC console Output routine 

UOO 

ST® 

store top of stack at user specified 
location (version 1.1 only) 

ST® 1000H 

ST® A 

LD® 

load top of stack from user specified 
location (version 1.1 only) 

LD® 1000H 

LD® A 

IDLE 

wait for interrupt (version 1.1 only) 

IDLE 

RROM 

run a program in EP(ROM) (version 1.1 
only) 

RROM 3 
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1.4 QUICK REFERENCE 

OPERATORS — DUAL OPERAND: 


OPERATOR 

FUNCTION 

EXAMPLE(S) 

+ 

ADDITION 

1+1 

/ 

DIVISION 

10/2 

★* 

EXPONENTATION 

2**4 

4r 

MULTIPLICATION 

4*4 

- 

SUBTRACTION 

8-4 

.AND. 

LOGICAL AND 

10.AND.5 

.OR. 

LOGICAL OR 

2.0R.1 

.XOR. 

LOGICAL EXCLUSIVE OR 

3.XOR.2 

OPERATORS — 

SINGLE OPERAND: 


ABS() 

ABSOLUTE VALUE 

ABS(-3) 

NOT() 

ONES COMPLEMENT 

NOT(O) 

INTO 

INTEGER 

INT(3.2) 

SGN() 

SIGN 

SGN(-5) 

SQR() 

SQUARE ROOT 

SQR(IOO) 

RND 

RANDOM NUMBER 

RND 

LOGO 

NATURAL LOG 

LOG(IO) 

EXPO 

“e” (2.7182818) TO THE X 

EXP(IO) 

SINO 

RETURNS THE SINE OF ARGUMENT 

SIN(3.14) 

COSO 

RETURNS THE COSINE OF 

ARGUMENT 

COS(O) 

TANO 

RETURNS THE TANGENT OF 

ARGUMENT 

TAN(.707) 

ATNO 

RETURNS ARCTANGENT OF 

ARGUMENT 

ATN(1) 
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1.4 QUICK REFERENCE 


OPERATORS — SPECIAL FUNCTION: 


CBY() 

READ PROGRAM MEMORY 

R CBY(4000) 

DBY() 

READ/ASSIGN INTERNAL DATA 

MEMORY 

DBY(99) = 10 

XBY() 

READ/ASSIGN EXTERNAL DATA 

MEMORY 

P. XBY(IO) 

GET 

READ CONSOLE 

R GET 

IE 

READ/ASSIGN IE REGISTER 

IE = 82H 

IP 

READ/ASSIGN IP REGISTER 

IP = 0 

PORT1 

READ/ASSIGN I/O PORT 1 (PI) 

PORT1=OFFH 

PCON 

READ/ASSIGN PCON REGISTER 

PCON=0 

RCAP2 

READ/ASSIGN RCAP2 
(RCAP2H:RCAP2L) 

RCAP2 = 100 

T2CON 

READ/ASSIGN T2CON REGISTER 

R T2CON 

TCON 

READ/ASSIGN TCON REGISTER 

TCON = 1 OH 

TMOD 

READ/ASSIGN TMOD REGISTER 

R TMOD 

TIME 

READ/ASSIGN THE REAL TIME CLOCK 

R TIME 

TIMERO 

READ/ASSIGN TIMERO (THO: TLO) 

TIMERO = 0 

TIMER1 

READ/ASSIGN TIMER1 (TH1:TL1) 

R TIMER1 

TIMER2 

READ/ASSIGN TIMER2 (TH2: TL2) 

TIMER2 = 0FFH 

STORED CONSTANT; 



PI 

PI - 3.1415926 

Rl 
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1.S INSTRUCTION SET SUMMARY 


COMMANDS 

STATEMENTS 

OPERATORS 

RUN 

BAUD 

ADD ( + ) 

CONT 

CALL 

DIVIDE (/) 

LIST 

CLEAR 

EXPONENTIATION (**) 

LIST# 

CLEAR(S&I) 

MULTIPLY (*) 

LIST® (V1.1) 

CLOCK(1&0) 

SUBTRACT(-) 

NEW 

DATA 

LOGICAL AND (.AND.) 

NULL 

READ 

LOGICAL OR (.OR.) 

RAM 

RESTORE 

LOGICAL X-OR (.XOR.) 

ROM 

DIM 

LOGICAL NOT (.OR.) 

XFER 

DO-WHILE 

ABS() 

PROG 

DO-UNTIL 

INT() 

PROG1 

END 

SGN() 

PROG2 

FOR-TO-STEP 

SQR() 

PROGS (V1.1) 

NEXT 

RND 

PROG4(V1.1) 

GOSUB 

logo 

PROGS (VI.1) 

RETURN 

EXPO 

PROG6(V1.1) 

GOTO 

SIN() 

FPROG 

ON-GOTO 

COSO 

FPROG1 

ON-GOSUB 

TAN() 

FPROG2 

IF-THEN-ELSE 

ATN() 

FPROG3 (V1.1) 

INPUT 

= , >, > = , <, < = , <> 

FPROG4 (V1.1) 

LET 

ASC() 

FPROG5 (V1.1) 

ONERR 

CHR() 

FPROG6 (V1.1) 

ONEX1 

CBY() 


ONTIME 

DBY() 


PRINT 

XBY() 


PRINT# 

GET 


PRINT® (VI.1) 

IE 


PHO. 

IP 


PHO.# 

PORT! 


PHO.® (VI.1) 

PCON 


PHI. 

RCAP2 


PHI.# 

T2CON 


PHI.® (VI.1) 

TCON 


PGM (VI. 1) 

TMOD 


PUSH 

TIME 


POP 

TIMERO 


PWM 

TIMER1 


REM 

TIMER2 


RETI 

XTAL 


STOP 

MTOP 


STRING 

LEN 


Ul(1&0) 

FREE 


U0(1&0) 

LD® (V1.1) 

ST® (V1.1) 

IDLE (V1.1) 

RROM (V1.1) 

PI 
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1.6 FLOATING POINT FORMAT 


MCS BASIC-52 stores all floating point numbers in a normalized packed BCD format with an offset binary 
exponent. The simplest way to demonstrate the floating point format is to use an example. If the number 
PI (3.1415926) was stored in location X, the following would appear in memory. 

LOCATION 

VALUE 

DESCRIPTION 

X 

81H 

EXPONENT —81H = 10**1, 82H = 10**2, 

80H = 10**0, 7FH = 10**-1 etc. 

THE NUMBER ZERO IS REPRESENTED WITH A 
ZERO EXPONENT 

X-1 

OOH 

SIGN BIT —OOH = POSITIVE, 01H = NEGATIVE OTHER BITS ARE 
USED AS TEMPS ONLY DURING A CALCULATION 

X-2 

26H 

LEAST SIGNIFICANT TWO DIGITS 

X-3 

59H 

NEXT LEAST SIGNIFICANT TWO DIGITS 

X-4 

41H 

NEXT MOST SIGNIFICANT TWO DIGITS 

X-5 

31H 

MOST SIGNIFICANT TWO DIGITS 


Because MCS BASIC-52 normalizes all numbers, the most significant digit is never a zero unless the 
number is zero. 
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1.7 STORAGE ALLOCATION 

This section is intended to answer the question — where does MCS BASIC-52 store its variables and 
strings? 

Two 16 bit pointers stored in external memory control the allocation of strings and variables and an 
additional two pointers control the allocation of scalar variables and dimensioned variables. These pointers 
are located and defined as follows: 

LOCATION (H-L) NAME DESCRIPTION 

10AH-10BH MTOP THE TOP OF RAM THAT IS ASSIGNED TO BASIC 

104H-105H VARTOP VARTOP = MTOP - (THE NUMBER OF BYTES OF MEM¬ 

ORY THAT THE USER HAS ALLOCATED FOR STRINGS). 

IF STRINGS ARE NOT USED, VARTOP = MTOP 

106H-107H VARUSE AFTER A NEW, CLEAR, OR RUN IS EXECUTED, VARUSE = 

VARTOP, EVERYTIME THE USER ASSIGNS OR USES A 
VARIABLE VARUSE IS DECREMENTED BY A COUNT OF 8. 

108H-109H DIMUSE AFTER A NEW, CLEAR, OR RUN IS EXECUTED, DIMUSE = 

[LENGTH OF THE USER PROGRAM THAT IS IN RAM MEM¬ 
ORY -I- STARTING ADDRESS OF THE USER PROGRAM IN 
RAM (512) + THE LENGTH OF ONE FLOATING POINT 
NUMBER (6)]. IF NO PROGRAM IS IN RAM MEMORY, 
DIMUSE = 518 AFTER A CLEAR IS EXECUTED 

MCS BASIC-52 stores string variables between VARTOP and MTOP. $(0) is stored from VARTOP to 
VARTOP -I- (user defined string length + 1), $(1) is stored from VARTOP -t- (user defined string length 
-I- 1) -I- 1 to VARTOP -I- 2 * (user defined string length -I- 1) etc. If MCS BASIC-52 attempts to access 
a string that is outside the bounds established by MTOP, a MEMORY ALLOCATION ERROR is generated. 

Now, Scalar variables are stored from VARTOP “down” and Dimensioned variables are stored from 
DIMUSE “up.” When the user dimensions a variable either implicity or explicity the value of DIMUSE 
increases by the number of bytes required to store that dimensioned variable. For example, if the user ex¬ 
ecutes a DIM A(10) statement, DIMUSE would increase by 66. This is because the user is requesting 
storage for 11 numbers (A(0) through A(10)) and each number requires 6 bytes for storage and 6 * 11 = 66. 
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1.7 STORAGE ALLOCATION 


As mentioned in the previous example, every time the user defines a new variable the VARUSE pointer 
decrements by a count of 8. Six of the eight counts are due to the memory required to store a floating 
point number and the other two counts are the storage required for the variable name (i.e. Al, B7, etc). 
The variable B7 would be stored as follows: 

LOCATION VALUE DESCRIPTION 

X 37H THE ASCII VALUE — 7, IF B7 WAS A DIMENSIONED VARIABLE THE 

MOST SIGNIFICANT BIT OF THIS LOCATION WOULD BE SET. IN 
VERSION 1.1 THIS LOCATION ALWAYS CONTAINS THE ASCII 
VALUE FOR THE LAST CHARACTER USED TO DEFINE A 
VARIABLE 


X-1 42H THE ASCII VALUE — B, IN VERSION 1.1 OF MCS BASIC-52 THIS 

LOCATION CONTAINS THE ASCII VALUE OF THE FIRST CHARAC¬ 
TER USED TO DEFINE A VARIABLE PLUS 26 * THE NUMBER OF 
CHARACTERS USED TO DEFINE A VARIABLE, IF THE VARIABLE 
CONTAINS MORE THAN 2 CHARACTERS. 


X-2 

THRU 

X-7 


?? THE NEXT SIX LOCATIONS WOULD CONTAIN THE FLOATING 
POINT NUMBER THAT THE VARIABLE IS ASSIGNED TO, IF THE 
VARIABLE WAS A SCALAR VARIABLE. IF THE VARIABLE WAS DI¬ 
MENSIONED, X-2 WOULD CONTAIN THE LIMIT OF THE DIMENSION 
(I.E. THE MAX. NUMBER OF ELEMENTS IN THE ARRAY) AND 
X-3: X-4 WOULD CONTAIN THE BASE ADDRESS OF THE ARRAY. 
THIS ADDRESS IS EQUAL TO THE OLD VALUE OF THE DIMUSE 
POINTER BEFORE THE ARRAY WAS CREATED 


Whenever a new scalar or dimensioned variable is used in a program, MCS BASIC-52 checks both the 
DIMUSE nd VARUSE pointers to make sure that VARUSE > DIMUSE. If the relationship is not true, a 
MEMORY ALLOCATION ERROR is generated. 
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1.7 STORAGE ALLOCATION 

To Summarize: 

Strings are stored from VARTOP to MTOP. 

Scalar variables are stored from VARTOP “down” and VARUSE points to the next available scalar location. 

Dimensioned variables are stored from the end of the user program in RAM “up.” If no program is in 
RAM this location is 518. DIMUSE keeps track of the number of bytes the user has allocated for dimensioned 
variables. 

If DIMUSE > = VARUSE a MEMORY ALLOCATION ERROR is generated 
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1.8 FORMAT OF AN MCS BASIC-52 PROGRAM 


This section answers the question “How does MCS BASIC-52 store a program?” 

LINE FORMAT 


Each line of MCS BASIC-52 text consists of tokens and ASCII characters, plus 4 bytes of overhead. Three 
of these four bytes are stored at the beginning of every line. The first byte contains the length of a line in 
binary and the second two bytes are the line number in binary. The fourth byte is stored at the end of the 
line and this byte is always a ODH or a carriage return in ASCII. An example of a typical line is shown 


below, assume 

that this is the first line of a program in RAM. 

10 FOR I = 

1 TO 10 

: PRINT I : NEXT I 

LOCATION 

BYTE 

DESCRIPTION 

512 

11H 

THE LENGTH OF THE LINE IN BINARY (17D BYTES) 

513 

OOH 

HIGH BYTE OF THE LINE NUMBER 

514 

OAH 

LOW BYTE OF THE LINE NUMBER 

515 

OAOH 

THE TOKEN FOR “FOR” 

516 

49H 

THE ASCII CHARACTER “1” 

517 

OEAH 

THE TOKEN FOR “ = ” 

518 

31H 

THE ASCII FOR “1” 

519 

0A6H 

THE TOKEN FOR “TO” 

520 

31H 

THE ASCII FOR “1” 

521 

30H 

THE ASCII FOR “0” 

522 

3AH 

THE ASCII FOR 

523 

89H 

THE TOKEN FOR “PRINT” 

524 

49H 

THE ASCII FOR “1” 

525 

3AH 

THE ASCII FOR 

526 

97H 

THE TOKEN FOR “NEXT” 

527 

49H 

THE ASCII FOR “1” 

528 

ODH 

END OF LINE (CARRIAGE RETURN) 


TO FIND THE LOCATION OF THE NEXT LINE, THE LENGTH OF THE LINE IS ADDED TO THE 
LOCATION WHERE THE LENGTH OF THE LINE IS STORED. IN THIS EXAMPLE, 

512 + 17D = 529, WHICH IS WHERE THE NEXT LINE IS STORED. 


The END of a program is designated by the value OlH. So, in the previous example if line 10 was the 
only line in the program, location 529 would contain the value OlH. A program simply consists of a number 
of lines packed together in one continuous block with the last line ending in a ODH, OlH sequence. 
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1.8 FORMAT OF AN MCS BASIC-52 PROGRAM 

EPROM FILE FORMAT . 

The EPROM FILE format consists of the same line and program format, previously described except that 
each program in the EPROM file begins with the value 55H. The value 55H is only used by MCS BASIC- 
52 to determine if a valid program is present. If the user types ROM 6, MCS BASIC-52 actually goes 
through the first program stored in EPROM line by line until the END of PROGRAM (OIH) is found, 
then it examines the next location to see if a 55H is stored in that location. It then goes through that 
program line by line. This process is repeated 6 times. If the character 55H is not found after the end of 
a program, MCS BASIC-52 will return with the PROM MODE error message. This would mean that less 
than six programs were stored in that EPROM. 

The first program stored in EPROM (ROM 1) always begins at location 801 OH and this location will always 
contain a 55H. The actual user program will begin at location 801IH. 

EPROM locations 8000H through 800FH are reserved by MCS BASIC-52. These locations contain ini¬ 
tialization information when the PROGX options are used. Version 1.0 of MCS BASIC-52 only used the 
first three bytes of this reserved EPROM area. The information stored in these bytes is as follows: 

LOCATION DESCRIPTION 

8000H CONTAINED A 31H IF PROG 1 WAS USED, CONTAINED A 32H IF PROG 2 
WAS USED 

8001H BAUD RATE (RCAP2H) 

8002H BAUD RATE (RCAP2L) 

Version 1.1 of MCS BASIC-52 uses the same locations as Version 1.0, but additionally locations 8003H 
and 8004H (high byte, low byte) are used to store the MTOP information for the PROG 3, 4, 5, 6 options. 

IMPORTANT NOTE — 

The PROG X options simply store ASCII character following the PROG command in loction 8000H. That 
is why PROG 1 stores a 31H in location 8000H, PROG 2 a 32H, PROG 3 (Version 1.1 only) a 33H etc. 

If the user employs the user defined reset option defined in Chapter 11 of this manual, it would be possible 

for the user to create unique PROG options. For example, PROG A would store a 41H in location 8000H 
and upon RESET the user could examine this location with an assembly language routine and generate a 
unique PROG A reset routine for that particular application. 
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1.9 ANSWERS TO A FEW QUESTIONS 

QUESTION 

Why can’t MCS BASIC-52 access the 8052’s SPECIAL FUNCTION REGISTER SCON? 

ANSWER 

The only time the user would likely change the contents of SCON is if the user is writing custom I/O 
drivers in assembly language. If the user is writing assembly language I/O drivers, then the user can change 
the contents of SCON in assembly language. Changing the contents of SCON can cause MCS BASIC- 
52’s console routines to crash. 

QUESTION 

I have written an upload/download routine using my computer, but when I download a program, MCS 
BASIC-52 misses characters, why? 

ANSWER 

MCS BASIC-52 is actually capable of accepting characters at 38,400 baud. The problem is that after MCS 
BASIC-52 receives a carriage return (cr), it tokenizes the line of text that was just entered. Depending on 
how complicated and how long the line is, MCS BASIC-52 can take up to a couple of hundred milliseconds 
to tokenize the line. If the user keeps stuffing characters into the serial port while MCS BASIC-52 is 
tokenizing the line, the characters will be lost. What the user must do in the download routine is wait until 
MCS BASIC-52 responds with the prompt character (>) after a carriage return is sent to the MCS BASIC- 
52 device. The prompt (>) informs the user that MCS BASIC-52 is ready to receive characters from the 
console device. 

QUESTION 

I am writing in assembly language and I notice that the 8052AH has no decrement DPTR instruction. What 
is the easiest, shortest or simplest way to decrement the DPTR? 

ANSWER 

The shortest one we know is: 


XCH 

A, DPL 

; SWAPA<>DPL 

JNZ 

DECDP 

; DPH = DPH-1 IF DPL = 0 

DEC 

DPH 


DEC 

A 

; DPL = DPL-1 

XCH 

A, DPL 



This routine affects no flags or registers (except the DPTR) either! 
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1.9 ANSWERS TO A FEW QUESTIONS 

QUESTION 

After RESET or power-up, MCS BASIC-52 does not return the proper value for MTOP, what’s the 
problem? 

ANSWER 

Virtually everytime this problem occurs it is because something is wrong with the decoding circuitry in 
the system or one or more of the address lines to the RAM are open or shorted. The user should make 
sure that all of the address lines to the system RAM are connected properly! 

A simple memory test can be implemented in the COMMAND MODE to verify the addressing to the 
RAM. First set XBY(IOOOH) = 55, then walk ones across the address (i.e. P. XBY(IOOIH) - P. 
XBY(1002H) - P. XBY(1004H) - P. XBY(1008H) P. XBY(IOIOH)) until all locations are tested. If 
for instance, P. XBY(1008H) returns a result of 55, then address line 3 (A3) would probably be open or 
shorted. 
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1.10 PIN-OUT LIST 

The following is a pin-out list of the most common devices found in an MCS BASIC-52 system: 


veeIT 



jf] Vcc 

INPUT A [T 



iH Vcc 

INPUT A [T 



"iil INPUT D1 

RESPONSE r— 
CONTROL A Li- 



Tal INPUT 0 

OUTPUT A (T 


'l2l INPUT D2 

OUTPUT A [T 


RESPONSE 
-> CONTROL D 

INPUT B1 [T 


TT] OUTPUT D 

INPUT B [T 


TTj OUTPUT D 

INPUT B2 [T 

3 


To] INPUT Cl 

RESPONSE 1— 
CONTROL B L5- 



To] INPUT C 

OUTPUT B [T 

5 

T] INPUT C2 

OUTPUT B (T 


■Jl RESPONSE 
— ' CONTROL C 

GND [T 


T] OUTPUT C 

GROUND [T 


T] OUTPUT C 



74LS373 


74LS32 





PB5 

|iPB4 

PPB3 


7406/LS04/LS05 
7407 NON¬ 
INVERTING 


8K X 8 SRAM 
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1.11 80S2AH SPECIAL FUNCTION REGISTERS 

The following details the operation of the special function registers on the 8052AH: 


SYMBOL 

NAME 

NAME 

ADDRESS 

MCS BASIC-52 

ACC 

Accumulator 

OEOH 

NOT ADDRESSABLE 

B 

B Register 

OFOH 

NOT ADDRESSABLE 

PSW 

Program Status Word 

ODOH 

NOT ADDRESSABLE 

SP 

Stack Pointer 

81H 

NOT ADDRESSABLE 

DPTR 

DPH 

Data Pointer 2 Bytes: 

Low Byte 

82H 

NOT ADDRESSABLE 

DPL 

High Byte 

83H 

NOT ADDRESSABLE 

PO 

Porto 

80H 

NOT ADDRESSABLE 

P1 

Port 1 

90H 

PORT1 

P2 

Port 2 

OAOH 

NOT ADDRESSABLE 

P3 

Port 3 

OBOH 

NOT ADDRESSABLE 

IP 

Interrupt Priority Control 

0B8H 

IP 

IE 

Interrupt Enable Control 

0A8H 

IE 

TMOD 

Timer/Counter Mode Control 

89H 

TMOD 

ICON 

Timer/Counter Control 

88H 

TCON 

T2CON 

Timer/Counter 2 Control 

0C8H 

T2CON 

THO 

Timer/Counter 0 High Byte 

8CH 


TLO 

Timer/Counter 0 Low Byte 

8AH 

} TIMERO 

TH1 

Timer/Counter 1 High Byte 

8DH 


TL1 

Timer/Counter 1 Low Byte 

8BH 

} TIMER1 

TH2 

Timer/Counter 2 High Byte 

OCDH 


TL2 

Timer/Counter 2 Low Byte 

OCCH 

} TIMER2 

RCAP2H 

T/C 2 Capture Reg. High Byte 

OCBH 


RCAP2L 

• 

T/C 2 Capture Reg. Low Byte 

OCAH 

} RCAP2 

SCON 

Serial Control 

98H 

NOT ADDRESSABLE 

SBUF 

Serial Data Buffer 

99H 

NOT ADDRESSABLE 

PCON 

Power Control 

87H 

NOT ADDRESSABLE 
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1.11 8052AH SPECIAL FUNCTION REGISTERS 

PSW: PROGRAM STATUS WORD. ADDRESS ODOH 



CY PSW.7 Carry Flag. 

AC PSW.6 Auxiliary Carry Flag. 

FO PSW.5 Flag 0 available to the user for general purpose. 

RS1 PSW.4 Register Bank selector bit 1. 

RSO PSW. 3 Register Bank selector bit 0. 

OV PSW.2 Overflow Flag. 

— PSW.l RESERVED FOR FUTURE USE. 

P PSW.O PARITY FLAG. 

PCON: POWER CONTROL REGISTER. NOT BIT ADDRESSABLE. 



SMOD Doubles the baud rate when TIMER 1 is used to generate the baud rate for the serial port. 
The remaining bits of PCON are not implemented on the MCS BASIC-52 device. 
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1.11 8052AH SPECIAL FUNCTION REGISTERS 


(MSB) (LSB) 



TIMER 1 TIMER 0 


GATE Gating control When set. Tim er/Counter “x” Ml MO Operating Mode 

is enabled only while “INTx” pin is high and 0 0 MCS-48 Timer “TLx” serves as five-bit 

“TRx” control pin Is set. When cleared Timer prescaler. 

“x” is enabled whenever “TRx” control bit is 0 1 16 bit Timer/Counter “THx” and “TLX” 

set are cascaded; there is no prescaler 

C/T Timer or Counter Selector Cleared for Timer 1 0 8-bit auto-reload timer-counter “THx” 

operation (input from Internal system clock). holds a value which is to be reloaded into 

Set for Counter operation (Input from “Tx” “TLx” each time it overflows, 

input pin). 

1 1 (Timer 0) TLO is an eight-bit timer 

counter-controlled by the 
standard Timer 0 control bits 
THO is an eight-bit timer only 
controlled by Timer 1 control 
bits. 

1 1 (Timer 1) Timer-counter 1 stopped. 


TMOD: Timer/Counter Mode Control Register 
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1.11 8052AH SPECIAL FUNCTION REGISTERS 



1 .- 

Symbol 

Position 

Name and Significance 

TF2 

T2CON.7 

Timer 2 overflow flag set by a Timer 2 overflow and must be cleared by software. TF2 
will not be set when either RCLK = 1 or TCLK = 1. 

EXF2 

T2CON.6 

Timer 2 external flag set when either a capture or reload is caused by a negative 
transition on T2EX and EXEN2 = 1. When Timer 2 interrupt is enabled, EXF2 = 1 
will cause the CPU to vector to the Timer 2 interrupt routine. EXF2 must be cleared by 
software. 

RCLK 

T2CON.5 

Receive clock flag. When set, causes the serial port to use Timer 2 overflow pulses 
for its receivb clock in modes 1 and 3. RCLK = 0 causes Timer 1 overflow to be used 
for the receive clock. 

TCLK 

T2CON.4 

Transmit clock flag. When set, causes the serial port to use Timer 2 overflow pulses 
for its transmit clock in modes 1 and 3. TCLK = 0 causes Timer 1 overflows to be 
used for the transmit clock. 

EXEN2 

T2CON.3 

Timer 2 external enable flag. When set, allows a capture or reload to occur as a result 
of a negative transition on T2EX if Timer 2 is not being used to clock the serial port. 
EXEN2 = 0 causes Timer 2 to ignore events at T2EX. 

TR2 

T2CON.2 

Start/stop control for Timer 2. A logic 1 starts the timer. 

C/T2 

T2CON.1 

Timer or counter select. (Timer 2) 

0 = Internal timer (OSC/12) 

1 = External event counter (falling edge triggered). 

CP/RL2 

T2CON.O 

Capture/Reload flag. When set, captures will occur on negative transitions at T2EX if 
EXEN2 = 1. When cleared, auto reloads will occur either with Timer 2 overflows or 
negative transitions at T2EX when EXEN 2 = 1. When either RCLK = 1 or TCLK = 1, 
this bit is Ignored and the timer is forced to auto-reload on Timer 2 overflow. 


Timer/Counter 2 Control Register 
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SMO SMI SM2 REN TBS RB8 Tl Rl 


where SMO, SM1 specify the serial port mode, as follows: 


SMO SM1 Mode Description Baud 

Rate 


shift ^osc./12 

register variable 

8- blt DART fosc./64 

9- blt UART or • RB8 

^osc./32 

9-bit UART variable 


is the 9th data bit that will be transmitted In 
modes 2 and 3. Set or clear by software as 
desired. 

In modes 2 and 3, is the 9th data bit that 
was received. In mode 1, if SM2 = 0, RB8 
is the stop bit that was received. In mode 0, 
RB8 is not used. 


• SM2 


enables the multiprocessor communication 
feature in modes 2 and 3. In mode 2 or 3, 
if SM2 is set to 1 then Rl will not be activated 
if the received 9th data bit (RB8) is 0. In 
mode 1, if SM2 = 1 then Rl will not be 
activated if a valid stop bit was not received, 
in mode 0, SM2 should be 0. 


REN enables serial reception. Set by software to 
enable reception. Clear by software to dis¬ 
able reception. 


Is transmit Interrupt flag. Set by hardware at 
the end of the 8th bit time in mode 0, or at 
the beginning of the stop bit in the other 
modes, In any serial transmission. Must be 
cleared by software. 

is receive interrupt flag. Set by hardware at 
the end of the 8th bit time In mode 0, or 
halfway through the stop bit time In the other 
modes. In any serial reception (except see 
SM2). Must be cleared by software. 


SCON: Serial Port Control Register 



TCON: Timer/Counter Control Register 
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1.11 8052AH SPECIAL FUNCTION REGISTERS 


[MSB) _LSB) 


X 

X 

PT2 

PS 

PT1 

PX1 

PTO 

PXO 


Symbol 

Position 

Function 

— 

IR7 

reserved 

— 

IP.6 

reserved 

PT2 

IP.5 

defines the Timer 2 interrupt 
priority level. PT2 = 1 programs 
it to the higher priority level. 

PS 

IP.4 

defines the Serial Port interrupt 
priority level. PS = 1 programs 
it to the higher priority level. 

PT1 

IP.3 

defines the Timer 1 interrupt 
priority level. PT1 = 1 programs 
it to the higher priority level. 

PX1 

IR2 

defines the External Interrupt 1 
priority level. PX1 = 1 programs 
it to the higher priority level. 

PTO 

IR1 

defines the Timer 0 interrupt 
priority level. PTO = 1 programs 
it to the higher priority level. 

PXO 

IRO 

defines the External Interrupt 0 
priority level. PXO = 1 programs 
it to the higher priority level. 


IP: Interrupt Priority Register 


[MSB) _ 


EA 

X 

CM 

ES 

ET1 

EX1 

ETO 

EXO 


Symbol 

Position 

Function 

EA 

iE.7 

disables all interrupts. If EA = 0, 
no interrupt will be acknowl¬ 
edged. If EA = 1, each interrupt 
source is individually enabled or 
disabled by setting or clearing its 
enable bit. 

— 

iE.6 

reserved 

ET2 

IE.5 

enables or disables the Timer 2 
overflow or capture interrupt. If 
ET2 = 0, the Timer 2 Interrupt 
is disabled. 

ES 

IE.4 

enables or disables the Serial 
Port interrupt. If ES = 0, the Se¬ 
rial Port Interrupt is disabled. 

ET1 

IE.3 

enables or disables the Timer 1 
Overflow interrupt. If ET1 = 0, 
the Timer 1 Interrupt is disabled. 

EX1 

IE.2 

enables or disables External In¬ 
terrupt 1. If EX1 = 0, External 
Interrupt 1 Is disabled. 

ETO 

IE.1 

enables or disables the Timer 0 
Overflow interrupt. If ETO = 0, 
the Timer 0 Interrupt is disabled. 

EXO 

IE.0 

enables or disables External In¬ 
terrupt 0. If EXO = 0, External 
Interrupt 0 Is disabled. 


IE: Interrupt Enable Register 
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APPENDIX B 


INSTRUCTION SET SUMMARY 

This appendix contains two tables (see tables B-1 and B-2): the first identifies all of the 8052’s instructions 
in alphabetical order; the second table lists the instructions according to their hexadecimal opcodes and 
lists the assembly language instructions that produced that opcode. 

The alphabetical listing also includes documentation of the bit pattern, flags affected, number of machine 
cycles per execution and a description of the instructions operation and function. The list below defines 
the conventions used to identify operation and bit patterns. 


ABBREVIATIONS AND NOTATIONS USED 


A 

Accumulator 

//////// 

One byte of a 16-bit 

AB 

Register Pair 


address encoded in 

B 

Multiplication Register 


operand byte 

bit address 

8052 bit address 

mmmmmmmm 

Data address encoded in 

page address 

11-bit code address within 


operand byte 

2K page 

00000000 

Relative offset encoded in 

relative offset 

8-bit 2’s complement offset 


operand byte 

C 

Carry Flag 

r or rrr 

Register identifier encoded 

code address 

Absolute code address 


in operand byte 

data 

Immediate data 

AND 

Logical AND 

data address 

On-chip 8-bit RAM address 

NOT 

Logical complement 

DPTR 

Data pointer 

OR 

Logical OR 

PC 

Program Counter 

XOR 

Logical exclusive OR 

Rr 

Register (r = 0-7) 

-I- 

Plus 

SP 

Stack pointer 

— 

Minus 

high 

High order byte 

/ 

Divide 

low 

Low order byte 

• 

Multiply 

H 

Bits i through j 

(X) 

The contents of X 

.n 

Bit n 

((X)) 

The memory location 

aaa aaaaaaaa 

Absolute page address 
encoded in instruction 


addressed by (X) 

(The contents of X) 


and operand byte 

— 

Is equal to 

bbbbbbbb 

Bit address encoded in 

< > 

Is not equal to 


operand byte 

< 

Is less than 

dddddddd 

Immediate data encoded in 

> 

Is greater than 


operand byte 


Is replaced by 
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Table B-1. Instruction Set Summary 


Mnemonic 

Operation 

Cycles 

Binary 

Code 

Flags 

P OV AC C 

Function 

ACALL code addr 
(PC) ^ (PC) + 2 
(SP) ^ (SP) + 1 
((SP)) ^ (PC) low 
(SP) ^ (SP) + 1 
((SP)) <- (PC) high 
(PC) 0-10 <- page address 

2 

a a a 1 0 0 0 1 

aaaaaaaa 


Push PC on stack, and 
replace low order 11 bits 
with low order 11 bits of 
code address. 

ADD A,#dafa 

(A) ^ (A) + data 

1 

00100100 

dddddddd 

P OV AC C 

Add immediate data to A. 

ADD A,@Rr 

(A) ^ (A) + ((Rr)) 

1 

0 0 1 0 0 1 1 r 

P OV AC C 

Add contents of indirect 
address to A. 

ADD A fir 

(A) ^ (A) + (Rr) 

1 

0 0 1 0 1 r r r 

P OV AC C 

Add register to A. 

ADD A,data addr 

(A) (A) + (data address) 

1 

00100101 

mmmmmmmm 

P OV AC C 

Add contents of data 
address to A. 

ADDC A,#c/afa 

(A) ^ (A) + (C) + data 

1 

00110100 

dddddddd 

P OV AC C 

Add C and immediate data 
to A. 

ADDC A,@Rf 

(A) ^ (A) + (C) + ((Rr)) 

1 

0 0 1 1 0 1 1 r 

P OV AC C 

Add C and contents of 
indirect address to A. 

ADDC A,Rr 

(A)<-(A) + (C) + (FV) 

1 

0 0 1 1 1 r r r 

P OV AC C 

Add C and register to A. 

ADDC A,data addr 

(A) <- (A) + (C) + (data address) 

1 

00110101 

mmmmmmmm 

P OV AC C 

Add C and contents of data 
address to A. 

AJMP code addr 

(PC) 0-10 ^ code address 


a a a 0 0 0 0 1 

aaaaaaaa 



ANL A,#Gfata 

(A) ^ (A) AND data 

1 

01010100 

dddddddd 

P 

Logical AND Immediate data 
to A. 

ANL A,@Rr 

(A) ^ (A) AND {(Rr)) 

1 

0 1 0 1 0 1 1 r 

P 

Logical AND contents of 
Indirect address to A. 

ANL A,Rr 

(A) ^ (A) AND (Rr) 

1 

0 1 0 1 1 r r r 

P 

Logical AND register to A. 

ANL A,data addr 

(A) ^ (A) AND (data address) 

1 

01010101 

mmmmmmmm 

P 

Logical AND contents of 
data address to A. 

ANL CM addr 

(C) <- (C) AND (bit address) 

2 

10000010 

bbbbbbbb 

C 

Logical AND bit to C. 

ANL C,lbit addr 

(C) (C) AND NOT (bit address) 

2 

10110000 

bbbbbbbb 

C 

Logical AND complement of 
bit to C. 

ANL data addr, #data 
(data address) 

(data address) AND data 

2 

01010011 

mmmmmmmm 

dddddddd 


Logical AND immediate data 
to contents of data address 

ANL data addr,A 
(data address) 

(data address) AND A 

1 

01010010 

mmmmmmmm 


Logical AND A to contents of 
data address. 
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Table B-1. Instruction Set Summary (Cont’d.) 


Mnemonic 

Operation 

Cycies 

Binary 

Code 

Fiags 

P OV AC C 

Function 

CJNE @Rr,#c/afa,coc/e addr 
(PC) ^ (PC) + 3 

IF ((Rr)) < > data 

THEN 

(PC) ^ (PC) + relative offset 

IF ((Rr)) <data 

THEN (C) 1 

ELSE (C) ^ 0 

2 


C 

If immediate data and 
contents of indirect address 
are not equal, jump to code 
address. 

CJNE A,#data,code addr 
(PC) ^ (PC) + 3 

IF (A) < > data 

THEN 

(PC) <- (PC) + relative offset 

IF (A) <data 

THEN (C) <- 1 

ELSE (C) <- 0 

2 


c 

If immediate data and A are 
not equal, jump to code 
address. 

CJNE A,data addr,code addr 
(PC) (PC) + 3 

IF (A) < > (data address) 

THEN 

(PC) (PC) + relative offset 

IF (A) < (data address) 

THEN (C) ^ 1 

ELSE (C) 4 - 0 

2 

10110101 

mmmmmmmm 

00000000 

c 

If contents of data address 
and A are not equal, jump to 
code address. 

CJNE Hr,^data,code addr 
(PC) (PC) + 3 

IF (Rr) < > data 

THEN 

(PC) (PC) + relative offset 

IF (Rr) < data 

THEN (C) ^ 1 

ELSE (C) <- 0 

2 

EQIIllll 

c 

If immediate data and 
register are not equal, jump 
to code address. 

CLR A 
(A)^0 

1 

11100100 

p 

Set A to zero (0). 

CLRC 

(0^0 

1 

11000011 

c 


CLR bit addr 

(bit address) <r- 0 

1 

11000010 

bbbbbbbb 


Set bit to zero (0). 

CPL A 

(A) 4- NOT (A) 

1 

11110100 

p 

Complements each bit in A. 

CPLC 

(C) ^ NOT (C) 

1 

10110011 

c 

Complement C. 

CPL bit addr 

(bit address) <- 

NOT (bit address) 

1 



Complement bit. 

DA A 

1 

11010100 

p 

c 

Adjust A after a BCD add. 

DEC @Rr 

((Rr)) 4- ((Rr)) - 1 




Decrement contents of 
indirect address. 

DEC A 

(A) ^ (A) - 1 

1 

00010100 

p 

Decrement A. 

DEC Rr 

(Rr) ^ (Rr) - 1 

1 

0 0 0 1 1 r r r 


Decrement register. 
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Table B-1. Instruction Set Summary (Cont’d.) 


Mnemonic 

Operation 

Cycles 

Binary 

Code 

Flags 

P OV AC C 

Function 

DEC data addr 

(data address) ^ 

(data address) - 1 

1 

00010101 

mmmrnmmmm 


Decrement contents of data 
address. 

DIV AB 

(AB) ^ {A)/(B) 

4 

10000100 

P ov c 

Divide A by B (multiplication 
register). 

DJNZ Rr,code addr 
(PC) (PC) + 2 
(Rr) ^ (Rr) - 1 

IF (Rr) <> 0 

THEN 

(PC) (PC) + relative offset 

2 

1 1 0 1 1 r r r 

00000000 


Decrement register, if not 
zero (0), then jump to code 
address. 

DJNZ data addr,code addr 
(PC), ^ (PC) + 3 
(data address) <r- 

(data address) - 1 

IF (data address) < > 0 

THEN 

(PC) (PC) + relative offset 

2 

11010101 

mmmrnmmmm 

00000000 


Decrement data address, if 
zero (0), then jump to code 
address. 

INC @ Rr 

((Rr)) ^ ((Rr)) + 1 

1 

0 0 0 0 0 1 1 r 


Increment contents of 
indirect address. 

INCA 

(A) ^ (A) + 1 

1 

00000100 

p 

Increment A. 

INC DPTR 

(DPTR) ^ (DPTR) + 1 

1 

10100011 


Increment 16-bit data 
pointer. 

INC Rr 

((R) ^ (Rr) + 1 

1 

0 0 0 0 1 r r r 


Increment register. 

INC data addr 

(data address) <- 

(data address) + 1 

2 

00000101 

mmmrnmmmm 


Increment contents of data 
address. 

JB bit addr,code addr 
(PC) ^ (PC) + 3 

IF (bit address) = 1 

THEN 

(PC) <- (PC) + relative offset 

2 

00100000 

bbbbbbbb 

00000000 


If bit Is one, n jump to code 
address. 

JBC bit addr,code addr 
(PC) ^ (PC) + 3 

IF (bit address) = 1 

THEN 

(bit address) <- 0 

(PC) (PC) + relative offset 

2 

00010000 

bbbbbbbb 

00000000 


If bit is one, n clear bit and 
jump to code address. 

JC code addr 

(PC) ^ (PC) + 2 

IF (C) = 1 

THEN 

(PC) <- (PC) + relative offset 

2 

01000000 

00000000 


If C Is one, then jump to 
code address. 

JMP @ A + DPTR 

(PC) ^ (A) + (DPTR) 

2 

01110011 


Add A to data pointer and 
jump to that code address. 

JNB bit addr,code addr 
(PC) (PC) + 3 

IF (bit address) = 0 

THEN 

(PC) (PC) + relative offset 

2 

00110000 

bbbbbbbb 

00000000 


If bit Is zero, n jump to code 
address. 
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Table B-1. Instruction Set Summary (Cont’d.) 


Mnemonic 

Operation 

Cycles 

Binary 

Code 

Flags 

P OV AC C 

Function 

JNC code addr 

(PC) + (PC) + 2 

IF (C) = 0 

THEN 

(PC) (PC) + relative offset 

2 



If C is zero (0), n jump to 
code address. 

JNZ code addr 

(PC) ^ (PC) + 2 

IF (A) <> 0 

THEN 

(PC) (PC) + relative offset 

2 

01110000 

00000000 


If A Is not zero (0), n jump to 
code address. 

JZ code addr 

(PC) ^ (PC) + 2 

IF (A) = 0 

THEN 

(PC) ^ (PC) + relative offset 

2 

01100000 

00000000 


If A is zero (0), then jump to 
code address. 

LCALL code addr 
(PC) (PC) + 3 
(SP) ^ (SP) + 1 
((SP)) ^ ((PC)) low 
(SP) (SP) + 1 
((SP)) ^ (PC) high 
(PC)«- code address 

2 

00010010 

I 1 1 1 M 1 It 

II 1 1 M 1 It 


Push PC on stack and 
replace entire PC value with 
code address. 

LJMP code addr 

(PC) code address 

2 

00000010 

I I I I I I I If 

I I I I I I I It 


Jump to code address. 

MOV @Rr,#c/afa 
((Rr)) data 

1 

0 1 1 1 0 1 1 r 
dddddddd 


Move Immediate data to 
Indirect address. 

MOV @fV,A 
((Rr))^(A) 

m 



Move A to indirect address. 

MOV @F{r,data addr 

((Rr)) <- (data address) 

H 



Move contents of data 
address to indirect address. 

MOV A,#dafa 
(A) «- data 

1 

WMiliH 


Move immediate data to A. 

MOV A,@Rr 
(A) ^ ((Rr)) 

1 


P 

Move contents of indirect 
address to A. 

MOV A,Rr 
(A)^(Rr) 

1 

1 1 1 0 1 r r r 


Move register to A. 

MOV A,data addr 

(A) (data address) 

1 

11100101 

mmmmmmmm 

P 

Move contents of data 
address to A. 

MOV C,bit addr 

(C) ^ (bit address) 

1 

10100010 

bbbbbbbb 

C 

Move bit to C. 

MOV DPTR,#c3fafa 
(DPTR) ^ data 

2 

10010000 

ddddddddt 

ddddddddt 


Move two bytes of 
immediate data pointer. 

MOV Rr,#ofafa 
(Rr) data 

1 


. 

Move immediate data to 
register. 

MOV Rr,A 
(Rr) ^ (A) 

1 

1 1 1 1 1 r r r 


Move A to register. 

t The high order byte of the 16-bit operand is in the first byte following the opcode. The low order byte is in the 
second byte following the opcode. 
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Table B-1. Instruction Set Summary (Cont’d.) 


Mnemonic 

Operation 

Cycles 

Binary 

Code 

Flags 

P OV AC C 

Function 

MOV f{r,data addr 

(Rr) (data address) 

2 

1 0 1 0 1 r r r 

mmmmmmmm 


Move contents of data 
address to register. 

MOV bit addr,C 

(bit address) (C) 

2 

10010010 

bbbbbbbb 


Move C to bit. 

MOV data addr,#data 
(data address) ^ data 

2 

01110101 

mmmmmmmm 

dddddddd 


Move immediate data to data 
address. 

MOV data addr,@Rr 

(data address) <r- ((Rr)) 

2 

1 0 0 0 0 1 1 r 

mmmmmmmm 


Move contents of indirect 
address to data address. 

MOV data addr,A 

(data address) <- (A) 

1 

11110101 

mmmmmmmm 


Move A to data address. 

MOV data addr,Rr 

(data address) ^ (Rr) 

2 

1 0 0 0 1 r r r 

mmmmmmmm 


Move register to data 
address. 

MOV data addr1,data addr2 
(data addressi) ^ ~ 

(data address2) 

2 

1 0 000 1 0 1 

mmmmmmmm* 

mmmmmmmm* 


Move contents of second 
data address to first data 
address. 

Move A,@A + DPTR 
(PC) ^ (PC) + 1 
(A) ^ ((A) + (DPTR)) 

2 

10010011 

p 

Add A to DPTR and move 
contents of that code 
address with A. 

Move A,@A + PC 
(A) 4- ((A) + (PC)) 

2 

10000011 

P 

Add A to PC and move 
contents of that code 
address with A. 

MOVX @DPTR,A 
((DPTR)) ^ (A) 

2 

11110000 


Move A to external data 
location addressed by 

DPTR. 

MOVX @HrA 
((Rr)) - (A) 

2 

1 1 1 1 0 0 1 r 


Move A to external data 
location addressed by 
register. 

MOVX A,@DPTR 
(A) ^ ((DPTR)) 

2 

11100000 

P 

Move contents of external 
data location addressed by 
DPTR to A. 

MOVX A,@Rr 
(A) ^ ((Rr)) 

2 

1 1 1 0 0 0 1 r 

P 

Move contents of external 
data location addressed by 
register to A. 

MUL AB 

(AB) ^ (A) * (B) 

4 

10100100 

POV 

c 

Multiply A by B 
(multiplication register). 

NOP 

1 

00000000 


Do nothing. 

ORL A,#data 

(A) ^ (A) OR data 

1 

01000100 
dddddddd 

p 

Logical OR immediate data 
to A. 

ORL A,@Ra 

(A) (A) OR ((Rr)) 

1 

0 1 0 0 0 1 1 r 

p 

Logical OR contents of 
indirect address to A. 

ORL A,Rr 

(A) 4- (A) OR (Rr) 

1 

0 1 0 0 1 r r r 

p 

Logical OR register to A. 

ORL A,data addr 

(A) ^ (A) OR (data address) 

1 

01000101 

mmmmmmmm 

p 

Logical OR contents of data 
address to A. 

ORL C,bit addr 

(C) ^ (C) OR (bit address) 

2 

01110010 

bbbbbbbb 

c 

Logical OR bit to C. 

* The source data address (second data address) is encoded in the first byte following the opcode. The destination 
data address is encoded in the second byte following the opcode. 
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Table B-1. Instruction Set Summary (Cont’d.) 


Mnemonic 

Operation 

Cycles 

Binary 

Code 

Flags 

P OV AC C 

Function 

ORL C,lbit addr 

(C) ^ (C) OR NOT (bit address) 

2 

10100000 

bbbbbbbb 

c 

Logical OR complement of 
bit to C. 

ORL data addr,#data 
(data address) ^ 

(data address) OR data 

2 

01000011 

mmmmmrnmm 

dddddddd 


Logical OR immediate data 
to data address. 

ORL data addr,A 
(data address) ^ 

(data address) OR A 

1 

01000010 

mmmmmrnmm 


Logical OR A to data 
address. 

POP data addr 

(data address) <- ((SP)) 

(SP) <- (SP) - 1 

2 

11010000 

mmmmmrnmm 


Place top of stack at data 
address and decrement SP. 

PUSH data addr 
(SP) <- (SP) + 1 
((SP)) ^ (data address) 

2 

11000000 

mmmmmrnmm 


Increment SP and place 
contents of data address at 
top of stack. 

RET 

(PC)high ^ ((SP)) 

(SP) (SP) - 1 
(PC)/ow^ <- ((SP)) 

(SP) ^ (SP) - 1 

2 

00100010 


Return from subroutine call. 

RETI 

(PC)high ((SP)) 

(SP) ^ (SP) - 1 
(PC)low 4- ((SP)) 

(SP) ^ (SP) - 1 

2 

00110010 


Return from Interrupt routine. 

RL A 

1 

00100011 


Rotate A left one position. 

RLC A 

1 

00110011 

P c 

Rotate A through C left one 
position. 

RR A 

1 

000000 1 1 


Rotate A right one position. 

RRC A 

1 

00010011 

P c 

Rotate A through C right one 
position. 

SETB C 
(0^1 

1 

11010011 

c 

Set C to one (1). 

SETB bit addr 

(bit address) ^ i 

1 

11010010 

bbbbbbbb 


Set bit to one (1). 

SJMP code addr 
(PC) <- (PC) + 2 
(PC) (PC) + relative offset 

2 

10000000 

00000000 


Jump to code address. 

SUBB A,#data 

(A) 4- (A) - (C) - data 

1 

10010100 

dddddddd 

P OV AC C 

Subtract immediate data 
from A. 

SUBB A,@Rr 

(A) ^ (A) - (C) - ({Hr)) 

1 

1 0 0 1 0 1 1 r 

P OV AC C 

Subtract contents of indirect 
address from A. 

SUBB A.R/- 

(A) <- (A) - (C) - (Rr) 

1 

1 0 0 1 1 r r r 

P OV AC C 

Subtract register from A. 

SUBB A,data addr 

(A) ^ (A) - (C) - (data address) 

1 

10010101 

mmmmmrnmm 

P OV AC C 

Subtract contents of data 
address from A. 

SWAP A 

1 

_i 

1 1 000 1 00 


Exchange low order nibble 
with high order nibble in A. 
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Table B*1. Instruction Set Summary (Cont’d.) 


Mnemonic 

Operation 

Cycles 

Binary 

Code 

Flags 

P OV AC C 

Function 

XCH A,@Rr 

temp <- ((Rr)) 

((Rr)) ^ (A) 

(A) ^ temp 

1 

1 1 0 0 0 1 1 r 

P 

Move A to indirect address 
and vice versa. 

XCH A,Rr 

temp <r- (Rr) 

(Rr) ^ (A) 

(A) <- temp 

1 

1 1 0 0 1 r r r 

P 

Move A to register and vice 
versa. 

XCH A,data addr 

temp <- {data address) 

{data address) ^ (A) 

(A) <- temp 

1 

11000101 

mmmmmmmm 

P 

Move A to data address and 
vice versa. 

XCHD A,@Rr 

temp ((Rr)) 0-3 
((Rr)) 0-3 ^ (A) 0-3 
(A) 0-3 temp 

1 

1 1 0 1 0 1 1 r 

P 

Move low order of A to low 
order nibble of indirect 
address and vice versa. 

XRL A,#c/afa 

(A) ^ (A) XOR data 

1 

01100100 

dddddddd 

P 

Logical exclusive OR 
Immediate data to A. 

XRL A,@Rr 

(A) ^ (A) XOR ((Rr)) 

1 

0 1 1 0 0 1 1 r 

P 

Logical exclusive OR 
contents of Indirect address 
to A. 

XRL A,Rr 

(A) ^ (A) XOR (Rr) 

1 

0 1 1 0 1 r r r 

P 

Logical exclusive OR register 
to A. 

XRL A,data addr 

(A) (A) XOR {data address) 

1 

01100101 

mmmmmmmm 

P 

Logical exclusive OR 
contents of data address to 

A. 

XRL data addr,data 
{data address) ^ 

{data address) XOR data 

2 

01100011 

mmmmmmmm 

dddddddd 


Logical exclusive OR 
immediate data to data 
address. 

XRL data addr,A 
{data address) 

{data address) XOR A 

1 

01100010 

mmmmmmmm 


Logical exclusive OR A to 
data address. 
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Hex 

Code 

Number 
of Bytes 

Mnemonic 

Operands 

00 

1 

NOP 


01 

2 

AJMP 

code addr 

02 

3 

LUMP 

code addr 

03 

1 

RR 

A 

04 

1 

INC 

A 

05 

2 

INC 

data addr 

06 

1 

INC 

@R0 

07 

1 

INC 

@R1 

08 

1 

INC 

RO 

09 

1 

INC 

R1 

OA 

1 

INC 

R2 

OB 

1 

INC 

R3 

OC 

1 

INC 

R4 

OD 

1 

INC 

R5 

OE 

1 

INC 

R6 

OF 

1 

INC 

R7 

10 

3 

JBC 

bit addr,code addr 

11 

2 

ACALL 

code addr 

12 

3 

LCALL 

code addr 

13 

1 

RRC 

A 

14 

1 

DEC 

A 

15 

2 

DEC 

data addr 

16 

1 

DEC 

@R0 

17 

1 

DEC 

@R1 

18 

1 

DEC 

RO 

19 

1 

DEC 

R1 

1A 

1 

DEC 

R2 

IB 

1 

DEC 

R3 

1C 

1 

DEC 

R4 

ID 

1 

DEC 

R5 

IE 

1 

DEC 

R6 

IF 

1 ' 

DEC 

R7 

20 

3 

JB 

bit addr,code addr 

21 

2 ■ 

AJMP 

code addr 

22 

1 

RET 


23 

1 

RL 

A 

24 

2 

ADD 

k,#data 

25 

2 

ADD 

A,data addr 

26 

1 

ADD 

A,@R0 

27 

1 

ADD 

A,@R1 

28 

1 

ADD 

A,R0 

29 

1 

ADD 

A,R1 

2A 

1 

ADD 

A,R2 

2B 

1 

ADD 

A,R3 

2C 

1 

ADD 

A,R4 

2D 

1 

ADD 

A,R5 

2E 

1 

ADD 

A,R6 

2F 

1 

ADD 

A,R7 

30 

3 

JNB 

bit addr,code addr 

31 

2 

ACALL 

code addr 

32 

1 

RETI 


33 

1 

RLC 

A 

34 

2 

ADDC 

A,#c/afa 

35 

2 

ADDC 

A,data addr 

36 

1 

ADDC 

A,@R0 

37 

1 

ADDC 

A,@R1 

38 

1 

ADDC 

A,R0 

39 

1 

ADDC 

A,R1 

3A 

1 

ADDC 

A,R2 

3B 

1 

ADDC 

A,R3 
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Table B-2. Instruction Opcodes In Hexadecimal (Cont’d.) 


Hex 

Code 

Number 
of Bytes 

Mnemonic 

Operands 

3C 

1 


A,R4 

3D 

1 


A,R5 

3E 

1 


A,R7 

3F 

1 


A,R7 

40 

2 


code addr 

41 

2 


code addr 

42 

2 

ORL 

data addr,A 

43 

3 

ORL 

data addr,^data 

44 

2 

ORL 

A,#dafa 

45 

2 

ORL 

A,data addr 

46 

1 

ORL 

A,@R0 

47 

1 

ORL 

A,@R1 

48 

1 

ORL 

A,R0 

49 

1 

ORL 

A.R1 

4A 

1 

ORL 

A,R2 

4B 

1 

ORL 

A,R3 

4C 

1 

ORL 

A,R4 

4D 

1 

ORL 

A,R5 

4E 

1 

ORL 

A,R6 

4F 

1 

ORL 

A,R7 

50 

2 

JNC 

code addr 

51 

2 

ACALL 

code addr 

52 

2 

ANL 

data addr,A 

53 

3 

ANL 

data addr,^data 

54 

2 

ANL 

A,#data 

55 

2 

ANL 

A,data addr 

56 

1 

ANL 

A,@R0 

57 

1 

ANL 

A,@R1 

58 

1 

ANL 

A,R0 

59 

1 

ANL 

A,R1 

5A 

1 

ANL 

A,R2 

5B 

1 

ANL 

A,R3 

5C 

1 

ANL 

A,R4 

5D 

1 

ANL 

A,R5 

5E 

1 

ANL 

A,R6 

5F 

1 

ANL 

A,R7 

60 

2 

JZ 

code addr 

61 

2 

AJMP 

code addr 

62 

2 

XRL 

data addr,A 

63 

3 

XRL 

data addr,#data 

64 

2 

XRL 

A,#data 

65 

2 

XRL 

A,data addr 

66 

1 

XRL 

A,@R0 

67 

1 

XRL 

A,@R1 

68 

1 

XRL 

A,R0 

69 

1 

XRL 

A,R1 

6A 

1 1 

XRL 

A,R2 

6B 

1 

XRL 

A,R3 

6C 

1 

XRL 

A,R4 

6D 

1 

XRL 

A,R5 

6E 

1 

XRL 

A,R6 

6F 

1 

XRL 

A,R7 

70 

2 

JNZ 

code addr 

71 

2 

ACALL 

code addr 

72 

2 

ORL 

C,bit addr 

73 

1 

JMP 

@A + DPTR 

74 

2 

MOV 

A,#data 

75 

3 

MOV 

data addr,#data 

76 

2 

MOV 

@R0,#dafa 

77 

2 

MOV 

@R1,#dafa 
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Table B-2. Instruction Opcodes In Hexadecimal (Cont’d.) 


Hex 

Code 

Number 
of Bytes 

Mnemonic 

Operands 

78 

2 

MOV 

R0,#G(afa 

79 

2 

MOV 

R1,#cyafa 

7A 

2 

MOV 

R2,#cyafa 

7B 

2 

MOV 

R3,#ofafa 

7C 

2 

MOV 

R4,#dafa 

7D 

2 

MOV 

R5,#da/a 

7E 

2 

MOV 

R6,#dafa 

7F 

2 

MOV 

R7,#c/afa 

80 

2 

SJMP 

coofd addr 

81 

2 

AJMP 

code addr 

82 

2 

ANL 

C,bit addr 

83 

1 

Move 

A,@A + PC 

84 

1 

DIV 

AB 

85 

3 

MOV 

data addr, data addr 

86 

2 

MOV 

data addr,@R0 

87 

2 

MOV 

data addr,@R^ 

88 

2 

MOV 

data addr,R0 

89 

2 

MOV 

data addr,R1 

8A 

2 

MOV 

data addr,R2 

8B 

2 

MOV 

data addr,R3 

8C 

2 

MOV 

data addr,f{4 

8D 

2 

MOV 

data addr,R5 

8E 

2 

MOV 

data addr,R6 

8F 

2 

MOV 

data addr,R7 

90 

3 

MOV 

DPTR,#c/afa 

91 

2 

ACALL 

code addr 

92 

2 

MOV 

bit addr,C 

93 

1 

Move 

A,@A + DPTR 

94 

2 

SUBB 

A,#c(afa 

95 

2 

SUBB 

A,data addr 

96 

1 

SUBB 

A,@R0 

97 

1 

SUBB 

A,@R1 

98 

1 

SUBB 

A,R0 

99 

1 

SUBB 

A,R1 

9A 

1 

SUBB 

A,R2 

9B 

1 

SUBB 

A,R3 

9C 

1 

SUBB 

A,R4 

9D 

1 

SUBB 

A,R5 

9E 

1 

SUBB 

A,R6 

9F 

1 

SUBB 

A,R7 

AO 

2 

ORL 

C,lbit addr 

A1 

2 

AJMP 

code addr 

A2 

2 

MOV 

C,bit addr 

A3 

1 

INC 

DPTR 

A4 

1 

MUL 

AB 

A5 


reserved 


A6 

2 

MOV 

@RO,ofafa addr 

A7 

2 

MOV 

@R1 ,data addr 

A8 

2 

MOV 

R0,data addr 

A9 

2 

MOV 

R1 ,data addr 

AA 

2 

MOV 

R2,data addr 

AB 

2 

MOV 

R3,data addr 

AC 

2 

MOV 

R4,data addr 

AD 

2 

MOV 

R5,data addr 

AE 

2 

MOV 

R6,data addr 

AF 

2 

MOV 

R7,data addr 

BO 

2 

ANL 

CJbit addr 

B1 

2 

ACALL 

code addr 

B2 

2 

CPL 

bit addr 

B3 

1 

CPL 

C 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont’d.) 


Hex 

Code 

Number 
of Bytes 

Mnemonic 

Operands 

B4 

3 

CJNE 

A,#c/afa,coc/e ad dr 

B5 

3 

CJNE 

A,data addr,code addr 

B6 

3 

CJNE 

@RO,#ofafa,coc/e addr 

B7 

3 

CJNE 

,#data,code addr 

B8 

3 

CJNE 

RO,#dafa,coc/e addr 

B9 

3 

CJNE 

R1 ,#data,code addr 

BA 

3 

CJNE 

R2,#data,code addr 

BB 

3 

CJNE 

R3,#dafa,code addr 

BC 

3 

CJNE 

R4,#dafa,code addr 

BD 

3 

CJNE 

R5,#date,code addr 

BE 

3 

CJNE 

R6,#dafa,code addr 

BF 

3 

CJNE 

R7,#dafa,code addr 

CO 

2 

PUSH 

data addr 

C1 

2 

AJMP 

code addr 

C2 

2 

CLR 

bit addr 

C3 

1 

CLR 

C 

C4 

1 

SWAP 

A 

C5 

2 

XCH 

A,data addr 

C6 

1 

XCH 

A,@R0 

C7 

1 

XCH 

A,@R1 

C8 

1 

XCH 

A,R0 

C9 

1 

XCH 

A,R1 

CA 

1 

XCH 

A,R2 

CB 

1 

XCH 

A,R3 

CC 

1 

XCH 

A,R4 

CD 

1 

XCH 

A,R5 

CE 

1 

XCH 

A,R6 

CF 

1 

XCH 

A,R7 

DO 

2 

POP 

data addr 

D1 

2 

ACALL 

code addr 

D2 

2 

SETB 

bit addr 

D3 

1 

SETS 

0 

D4 

1 

DA 

A 

D5 

3 

DJNZ 

data addr,code addr 

D6 

1 

XCHD 

A,@R0 

D7 

1 

XCHD 

A,@R1 

D8 

2 

DJNZ 

RO,code addr 

D9 

2 

DJNZ 

R1 ,code addr 

DA 

2 

DJNZ 

R2,code addr 

DB 

2 

DJNZ 

R3,code addr 

DC 

2 

DJNZ 

R4,code addr 

DD 

2 

DJNZ 

R5,code addr 

DE 

2 

DJNZ 

R6,code addr 

DF 

2 

DJNZ 

R7,code addr 

EO 

1 

MOVX 

A,@DPTR 

E1 

2 

AJMP 

code addr 

E2 

1 

MOVX 

A,@R0 

E3 

1 

MOVX 

A,@R1 

E4 

1 

CLR 

A 

E5 

2 

MOV 

A,data addr 

E6 

1 

MOV 

A,@R0 

E7 

1 

MOV 

A,@R^ 

E8 

1 

MOV 

A,R0 

E9 

1 

MOV 

A,R1 

EA 

1 

MOV 

A,R2 

EB 

1 

MOV 

A,R3 

EC 

1 

MOV 

A,R4 

ED 

1 

MOV 

A,R5 

EE 

1 

MOV 

A,R6 

EF 

1 

MOV 

A,R7 
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Table B-2. Instruction Opcodes In Hexadecimal (Cont’d.) 


Hex 

Code 

Number 
of Bytes 

Mnemonic 

Operands 

FO 

1 

MOVX 

@DPTR,A 

F1 

2 

ACALL 

code addr 

F2 

1 

MOVX 

@R0,A 

F3 

1 

MOVX 

@R1 ,A 

F4 

1 

CPL 

A 

F5 

2 

MOV 

data addr,A 

F6 

1 

MOV 

@R0,A 

F7 

1 

MOV 

@R1,A 

F8 

1 

MOV 

R0,A 

F9 

1 

MOV 

R1,A 

FA 

1 

MOV 

R2,A 

FB 

1 

MOV 

R3,A 

FC 

1 

MOV 

R4,A 

FD 

1 

MOV 

R5,A 

FE 

1 

MOV 

R6,A 

FF 

1 

MOV 

R7,A 
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ABS, 5, 76, 113, 158, 181, 183 
Accumulator, 27, 106, 123, 146, 147, 193 
ADD, 5, 8, 74, 80, 118, 119, 181, 183 
Argument Stack, 8, 31, 60, 61, 98, 106-108, 
112, 113, 118, 122, 123, 163, 165, 167, 
169 

Arithmetic Overflow, 97, 118 

Arithmetic Underflow, 97, 118 

Array Size, 99 

ASC, 83-85, 103, 158, 183 

Assembly Language Linkage, 29, 67, 99, 104 

ATN, 79, 114, 158, 181, 183 

Auto_Baud, 2 

B 

BAUD Rate, 16, 24, 27, 28, 57, 89, 93, 94, 
131, 145-147, 158, 164, 169, 174, 175, 
178, 183, 189, 194 

c 

CALL, 12, 29, 104, 107, 108, 130, 132, 158, 
178, 183 

Carry Bit, 27, 146 
CBY, 86, 114, 158, 182, 183 
CHR, 83, 85, 158, 183 
CLEAR, 6, 30, 32, 35, 66 158, 178 
CLEARI, 31, 32, 53, 178, 183 
CLEARS, 31, 178, 183 
CLOCKO, 32, 53, 158, 178, 183 
CLOCK1, 30-32, 52, 91, 92, 131, 158, 163, 
167, 178, 183 

Command Mode, 4, 12, 13, 24, 106, 109, 

111, 167, 191 

Command/Statement Extension, 10, 11, 122, 
153-159 

Constants, 5, 6, 122 
CONT, 14, 38, 65, 158, 166, 176, 183 
Control Stack, 8, 11, 31, 42, 98, 169 
COS, 5, 77-79, 113, 158, 181, 183 
CR, 4, 55, 158 

D 

DATA, 33, 34, 97, 158, 178, 183 

Data Format, 5 

DBY, 86, 114, 158, 182, 183 


DIM, 6, 35, 99, 158, 167, 178, 183 
DIMUSE, 185, 186 

Direct Memory Access (DMA), 101, 129, 

163, 167 

DIVIDE, 5, 8, 80, 118, 119, 181, 183 
DO_UNTIL, 8, 31, 36, 37, 98, 158, 178, 183 
DO_WHILE, 8, 31, 37, 98, 158, 178, 183 
DPTR, 104, 106, 123, 147, 153, 155, 159, 
190, 193 

E 

END, 38, 158, 178, 183, 188 
EPROM Programming, 10, 20, 23, 72, 109, 
110, 132, 134-136, 141, 142, 162 
EQUAL, 7, 80, 81, 120, 158, 183 
Error Messages, 96-99 
EXCLUSIVE OR, 120, 158 
EXP, 78, 158, 181, 183 
EXPONENT, 74, 80, 119, 181, 183 
Expression, 6 

F 

Floating Point Numbers, 55, 71, 107, 108, 
112, 118, 123, 184, 186 
FOR_TO_{STEP}_NEXT, 8, 11, 12, 31, 39, 
40, 42, 98, 158, 178, 183 
FPROG, 25, 94, 158, 177, 183 
FPROG1, 25, 177, 183 
FPROG2, 25, 177, 183 
FPROG3, 26, 177, 183 
FPROG4, 26, 177, 183 
FPROG5, 27, 177, 183 
FPROG6, 27, 177, 183 
FREE, 7, 21, 95, 115, 158, 183 

G 

GET, 67, 86, 87, 100, 115, 122, 123, 158, 
162, 165, 166, 169, 182, 183 
GOSUB, 8, 11, 12, 41, 43, 44, 51, 52, 61, 

98, 158, 179, 183 

GOTO, 12, 13, 43, 44, 46, 158, 179, 183 
GREATER THAN, 7, 80, 81, 121, 158, 183 
GREATER THAN OR EQUAL, 7, 80, 81, 

120, 158, 183 


213 




MCS® BASIC-52 


inter 


I 

IDLE, 10, 69, 158, 167, 180, 183 
IE, 31, 51, 88, 101, 103, 116, 129, 130, 158, 
182, 183, 193, 198 

IF_THEN_ELSE, 9, 45, 46, 97, 158, 179, 
183 

Illegal Direct, 97 

INPUT, 47, 48, 82, 158, 179, 183 
Input Buffer, 11, 111 
INT, 76, 113, 158, 181, 183 
Integers, 5, 75, 76 

INTELIigent Algorithm, 25, 26, 72, 109, 110, 
136, 141, 163, 165, 167, 169, 177 
Internal Stack, 8, 99 

Interrupts, 129, 130, 159, 160, 162, 163, 

166, 167 

IP, 88, 116, 158, 182, 183, 193, 198 

L 

LD@, 10, 71, 158, 180, 183 
LEN, 7, 95, 115, 158, 183 
LESS THAN, 7, 80, 81, 121, 158, 183 
LESS THAN OR EQUAL, 7, 80, 81, 120, 
158, 183 

LET, 49, 66, 82, 86, 91, 95, 158, 179, 183 
Line Editor, 8 

LIST, 4, 9, 10, 15-17, 21, 100, 158, 176, 

183 

LIST#, 16, 28, 94, 131, 176, 183 
LIST®, 11, 17, 59, 159, 166, 167, 176, 183 
LOG, 78, 114, 158, 181, 183 
LOGICAL AND, 76, 80, 81, 120, 158, 181, 
183 

LOGICAL EXCLUSIVE OR, 75, 80, 81, 181, 
183 

LOGICAL OR, 75, 80, 81, 120, 158, 181, 

183 

M 

MTOP, 2, 7, 21, 26, 27, 95, 115, 145, 152, 
158, 176, 183, 185, 187, 189, 191 
MULTIPLY, 8, 74, 80, 118, 119, 181, 183 

N 

NEGATION, 80, 158 
NEW, 18, 35, 66, 158, 176, 183 
NOT, 76, 81, 113, 158, 181, 183 
NOT EQUAL, 7, 80, 81, 121, 158, 183 
NULL, 19, 95, 158, 166, 176, 183 


o 

ON GOSUB, 43, 44, 158, 179 
ON GOTO, 43, 44 158, 179 
ONERR, 30, 50, 158, 162, 166, 169, 179, 
183 

ONEX1, 30, 31, 51, 53, 64, 69, 129, 131, 
158, 162, 166, 169, 179, 183 
ONTIME, 30, 31, 51, 52, 53, 64, 69, 129, 
158, 162, 166, 168, 179, 183 
ON_GOSUB, 183 
ONGOTO, 183 
Opbyte, 11,106-109, 111-124 
Operators, 122 

P 

PCON, 89, 117, 158, 182, 183, 193, 194 
PGM, 10, 72, 73, 104, 158, 180 183 
PHO., 58, 158, 179, 183 
PHO.#, 58, 179, 183 
PH0.@, 59, 180, 183 
PHI., 58, 157, 158, 179, 183 
PHI.#, 58, 179, 183 
PHI.@, 59, 180, 183 
PI, 77, 79, 115, 158, 182, 183 
POP, 60, 61, 98, 106, 108, 118, 130, 158, 
180, 183 

PORT1, 88, 117, 158, 182, 183 
PRINT, 4, 10, 11, 54, 55, 57-59, 63, 158, 
179, 183 

PRINT#, 28, 57, 94, 131, 179, 183 
PRINT®, 11, 59, 159, 166, 167, 180, 183 
PROG, 23, 25, 94, 131, 134, 158, 176, 183, 
189 

PROG1, 10, 24, 25, 145, 176, 183, 189 
PROG2, 10, 24, 25, 145, 176, 183, 189 
PROG3, 10, 26, 145, 176, 183, 189 
PROG4, 10, 26, 145, 176, 183 
PROG5, 10, 27, 145, 177, 183 
PROG6, 10, 27, 146, 177, 183 
Programming Error, 98 
PSW, 130, 160, 193, 194 
PUSH, 60, 61, 98, 107, 130, 158, 180, 183 
PWM, 62, 90, 94, 131, 158, 170-173, 180, 
183 
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R 

RAM, 21, 158, 176, 183 

RAM Only Mode, 132 

RAM/EPROM Mode, 133, 134 

RCAP2, 89, 117, 158, 182, 183 

READ, 33, 34, 97, 158, 178, 183 

REM, 12, 63, 158, 180, 183 

Reset, 2, 3, 10, 24, 26, 27, 29, 102, 122, 

131, 145-152, 159, 176, 177, 191 
RESTORE, 33, 158, 178, 183 
RETI, 51, 53, 64, 158, 163, 180, 183 
RETURN, 41, 42, 64, 98, 123, 158, 179, 183 
RND, 77, 115, 158, 181, 183 
ROM, 21, 158, 176, 183 
RROM, 10, 70, 158, 180, 183 
RUN, 13, 21, 24, 35, 43, 100, 158, 176, 183 
Run Mode, 4, 13, 123 
Run Trap, 10, 27, 102, 169 

s 

SCON, 147, 190, 193, 197 
Serial Port, 131, 136, 159, 160, 166 
SON, 76, 113, 158, 181, 183 
Sign-On, 2 

SIN, 5, 77-79, 114, 158, 181, 183 
SMOD, 194 
SPC, 4, 54, 158 
SQR, 77, 114, 158, 181, 183 
ST@, 10, 71, 158, 180, 183 
Stack Pointer, 8, 31, 105, 147, 152, 193 
STOP, 14, 65, 98, 158, 163, 176, 180, 183 
STRING, 30, 49, 66, 82, 83, 99, 158, 164, 
168, 180, 183, 185 

SUBTRACT, 5, 8, 74, 80, 118-120, 181, 183 


T 

T2CON, 2, 3, 89, 116, 131, 147, 158, 182, 
183, 193 
TAB, 4, 54, 158 

TAN, 77, 79, 113, 158, 181, 183 
TCON, 3, 90, 116, 131, 147, 158, 182, 183, 
193, 197 

Text Pointer, 122, 123, 162, 164, 166 
TiME, 7, 32, 52, 53, 91, 92, 116, 158, 182, 
183 

TIMERO, 90, 92, 116, 158, 182, 183 
TIMER1, 89, 90, 92, 94, 116, 158, 182, 183 
TIMER2, 89, 92, 94, 116, 158 174, 175, 182, 
183, 196 

TMOD, 3, 90, 117, 131, 147, 158, 182, 183, 
193, 195 

u 

Ul, 67, 158, 180, 183 
UNTIL, 178 
UO, 68, 158, 180, 183 
USING, 4, 55, 56, 112, 158 

V 

Variables, 6, 11, 122, 185 
VARTOP, 185, 187 
VARUSE, 185-187 

X 

X-OFF, 10 
X-ON, 10 

XBY, 87, 114, 158, 182, 183 
XFER, 21, 22, 158, 176, 183 
XTAL, 2, 3, 7, 28, 32, 62, 89, 91, 93, 115, 
136, 152, 158, 165, 169, 174, 175, 183 
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TWX: 310-371-9127 

5835B Peachtree Corners E 

Arrow Electronics, Inc. 

1175 Bordeaux Drive 


Norcross 30092 

755 Phoenix Drive 

Sunnyvale 94086 

Tel: (408) 743-3300 

Wyle Systems 

Tel: (404) 448-1711 

Ann Arbor 48104 

7382 Lampson Avenue 

TWX. 810-766-4515 

Tel: (313) 971-8220 

TWX. 910-339-9332 

Garden Grove 92641 

Tel: (714) 851-9953 

ILLINOIS 

TWX: 810-223-6020 

fHamilton/Avnet Electronics 

TWX: 910-595-2642 


fHamilton/Avnet Electronics 

4545 Viewridge Avenue 


fArrow Electronics, Inc. 

32487 Schoolcraft Road 

San Diego 92123 

COLORADO 

2000 E. Alonquin Street 

Livonia 48150 

Tel: (619)571-7500 


Schaumberg 60195 

Tel: (313) 522-4700 

TWX: 910-595-2638 

Arrow Electronics, Inc. 

1390 S. Potomac Street 

Tel: (312) 397-3440 

TWX. 910-291-3544 

TWX: 810-242-8775 

fHamilton/Avnet Electronics 

Suite 136 


Hamilton/Avnet Electronics 

20501 Plummer Street 

Aurora 80012 

fHamilton/Avnet Electronics 

2215 29th Street S.E. 

Chatsworth 91311 

Tel: (303) 696-1111 

1130 Thorndale Avenue 

Space A5 

Tel: (818) 700-6271 

Bensenville 60106 

Grand Rapids 49508 

TWX: 910-494-2207 

fHamilton/Avnet Electronics 

Tel: (312) 860-7780 

Tel: (616) 243-8805 

fHamilton/Avnet Electronics 

8765 E. Orchard Road 

Suite 708 

TWX: 910-227-0060 

TWX: 810-273-6921 

4103 Northgate Boulevard 

Englewood 80111 

MTI Systems Sales 

f Pioneer Electronics 

Sacramento 95834 

Tel: (303) 740-1017 

1100 West Thorndale 

13485 Stamford 

Tel: (916) 920-3150 

TWX: 910-935-0787 

Itasca 60143 

Tel: (312) 773-2300 

Livonia 48150 

Tel: (313) 525-1800 

Hamilton/Avnet Electronics 

fWyle Distribution Group 

451 E. 124th Avenue 

TWX: 810-242-3271 

3002 G Street 

f Pioneer Electronics 


Ontario 91311 

Thornton 80241 

1551 Carmen Drive 

MINNESOTA 

Tel: (714) 989-9411 

Tel: (303) 457-9953 

Elk Grove Village 60007 


TWX: 910-936-0770 

Tel: (312) 437-9680 

fArrow Electronics, Inc. 

Hamilton/Avnet Electronics 


TWX: 910-222-1834 

5230 W. 73rd Street 

19515 So. Vermont Avenue 

CONNECTICUT 


Edina 55435 

Torrance 90502 


INDIANA 

Tel: (612) 830-1800 

Tel: (213) 615-3909 

f Arrow Electronics, Inc. 


TWX: 910-576-3125 

TWX: 910-349-6263 

12 Beaumont Road 

fArrow Electronics, Inc. 



Wallingford 06492 

Tel: (203) 265-7741 

2495 Directors Row, Suite H 

Hamilton/Avnet Electronics 

Hamilton Electro Sales 

Indianapolis 46241 

10300 Bren Road East 

9650 De Soto Avenue 

TWX: 710-476-0162 

Tel: (317) 243-9353 

Minnetonka 55343 

Chatsworth 91311 


TWX: 810-341-3119 

Tel: (612) 932-0600 

Tel: (818) 700-6500 

fHamilton/Avnet Electronics 
Commerce Industrial Park 

Hamilton/Avnet Electronics 

TWX: (910) 576-2720 

f Hamilton Electro Sales 

Commerce Drive 

485 Gradle Drive 

f Pioneer Electronics 

10950 W. Washington Boulevard 

Danbury 06810 

Tel: (203) 797-2800 

Carmel 46032 

10203 Bren Road East 

Culver City 90230 

Tel: (317) 844-9333 

Minnetonka 55343 

Tel: (213) 558-2458 

TWX: 910-340-6364 

TWX: 710-456-9974 

TWX: 810-260-3966 

Tel: (612) 935-5444 

TWX: 910-576-2738 
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DOMESTIC DISTRIBUTORS 



MISSOURI 

tArrow Electronics, Inc. 

2380 Schuetz 
St. Louis 63141 
Tel: (314) 567-6888 
TWX: 910-764-0882 

tHamilton/Avnet Electronics 
13743 Shoreline Court 
Earth City 63045 
Tel: (314) 344-1200 
TWX: 910-762-0684 

NEW HAMPSHIRE 

tArrow Electronics, Inc. 

3 Perimeter Road 
Manchester 03103 
Tel: (603) 668^6968 
TWX: 710-220-1684 

Hamilton/Avnet Electronics 
444 E. Industrial Drive 
Manchester 03104 
Tel: (603) 624-9400 

NEW JERSEY 

tArrow Electronics, Inc. 

6000 Lincoln East 
Marlton 08053 
Tel: (609) 596-8000 
TWX: 710-897-0829 

tArrow Electronics, Inc. 

2 Industrial Road 
Fairfield 07006 
Tel: (201)575-5300 
TWX: 710-998-2206 

tHamilton/Avnet Electronics 
1 Keystone Avenue 
Bldg. 36 

Cherry Hill 08003 
Tel: (609) 424-0110 
TWX: 710-940-0262 

tHamilton/Avnet Electronics 
10 Industrial 
Fairfield 07006 
Tel: (201)575-3390 
TWX: 701-734-4388 

tPioneer Northeast Electronics 
45 Route 46 
Pinebrook 07058 
Tel: (201)575-3510 
TWX: 710-734-4382 

tMTI Systems Sales 
383 Route 46 W 
Fairfield 07006 
Tel: (201)227-5552 

NEW MEXICO 

Alliance Electronics Inc. 

11030 Cochiti S.E. 

Albuquerque 87123 
Tel: (505) 292-3360 
TWX: 910-989-1151 

Hamilton/Avnet Electronics 
2524 Baylor Drive S.E. 

Albuquerque 87106 
Tel: (505) 765-1500 
TWX: 910-989-0614 

NEW YORK 

tArrow Electronics, Inc. 

25 Hub Drive 
Melville 11747 
Tel: (516) 694-6800 
TWX: 510-224-6126 

tArrow Electronics, Inc. 

3375 Brighton-Henrietta Townline Road 
Rochester 14623 
Tel: (716) 427-0300 
TWX: 510-253-4766 

Arrow Electronics, Inc. 

7705 Maltage Drive 
Liverpool 13088 
Tel: (315) 652-1000 
TWX: 710-545-0230 

Arrow Electronics, Inc. 

20 Oser Avenue 
Hauppauge 11788 
Tel: (516) 231-1000 
TWX: 510-227-6623 

Hamilton/Avnet Electronics 
333 Metro Park 
Rochester 14623 
Tel: (716) 475-9130 
TWX: 510-253-5470 

Hamilton/Avnet Electronics 
103 Twin Oaks Drive 
Syracuse 13206 
Tel: (315) 437-2641 
TWX: 710-541-1560 


NEW YORK (Cont’d) 

tHamilton/Avnet Electronics 
933 Motor Parkway 
Hauppauge 11788 
Tel: (516) 231-9800 
TWX: 510-224-6166 

tMTI Systems Sales 
38 Harbor Park Drive 
P.O. Box 271 
Port Washington 11050 
Tel: (516) 621-6200 
TWX: 510-223-0846 

tPioneer Northeast Electronics 
1806 Vestal Parkway East 
Vestal 13850 
Tel: (607) 748-8211 
TWX: 510-252-0893 

tPioneer Northeast Electronics 
60 Crossway Park West 
Woodbury, Long Island 11797 
Tel: (516) 921-8700 
TWX: 510-221-2184 

Pioneer Northeast Electronics 
840 Fairport Park 
Fairport 14450 
Tel: (716) 381-7070 
TWX: 510-253-7001 

NORTH CAROLINA 

Arrow Electronics, Inc. 

5240 Greendairy Road 
Raleigh 27604 
Tel: (919)876-3132 
TWX: 510-928-1856 

tHamilton/Avnet Electronics 
3510 Spring Forest Drive 
Raleigh 27604 
Tel: (919) 878-0819 
TWX: 510-928-1836 

Pioneer Electronics 

9801 A-Southern Pine Boulevard 

Charlotte 28210 

Tel: (704) 524-8188 

TWX: 810-621-0366 

OHIO 

Arrow Electronics, Inc. 

7620 McEwen Road 
Centerville 45459 
Tel: (513) 435-5563 
TWX: 810-459-1611 

tArrow Electronics, Inc. 

6238 Cochran Road 
Solon 44139 
Tel (216) 248-3990 
TWX: 810-427-9409 

tHamilton/Avnet Electronics 
954 Senate Drive 
Dayton 45459 
Tel: (513) 433-0610 
TWX: 810-450-2531 

tHamilton/Avnet Electronics 
4588 Emery Industrial Parkway 
Warrensville Heights 44128 
Tel: (216)831-3500 
TWX: 810-427-9452 

tPioneer Electronics 
4433 Interpoint Boulevard 
Dayton 45424 
Tel: (513) 236-9900 
TWX: 810-459-1622 

tPioneer Electronics 
4800 E. 131st Street 
Cleveland 44105 
Tel: (216) 587-3600 
TWX: 810-422-2211 

OKLAHOMA 

Arrow Electronics, Inc. 

4719 S. Memorial Drive 

Tulsa 74145 

Tel: (918) 665-7700 

OREGON 

tAlmac Electronics Corporation 
1885 N.W. 169th Place 
Beaverton 97006 
Tel: (503) 629-8090 
TWX: 910-467-8746 

Hamilton/Avnet Electronics 
6024 S.W. Jean Road 
Bldg. C, Suite 10 
Lake Oswego 97034 
Tel: (503) 635-7848 
TWX: 910-455-8179 

Wyle Distribution Group 

5250 N.E. Elam Young Parkway 

Suite 600 

Hillsboro 97124 

Tel: (503) 640-6000 

TWX: 910-460-2203 


PENNSYLVANIA 

Arrow Electronics, Inc. 

650 Seco Road 
Monroeville 15146 
Tel: (412) 856-7000 

Pioneer Electronics 
259 Kappa Drive 
Pittsburgh 15238 
Tel: (412) 782-2300 
TWX: 710-795-3122 

tPioneer Electronics 
261 Gibralter Road 
Horsham 19044 
Tel: (215) 674-4000 
TWX: 510-665-6778 

TEXAS 

tArrow Electronics, Inc. 

3220 Commander Drive 
Carrollton 75006 
Tel: (214) 380-6464 
TWX: 910-860-5377 

tArrow Electronics, Inc. 

10899 Kinghurst 
Suite 100 
Houston 77099 
Tel: (713) 530-4700 
TWX: 910-880-4439 

Arrow Electronics, Inc. 

10125 Metropolitan 
Austin 78758 
Tel: (512) 835-4180 
TWX:- 910-874-1348 

tHamilton/Avnet Electronics 
1807 W. Braker Lane 
Austin 78758 
Tel: (512)837-8911 
TWX: 910-874-1319 

tHamilton/Avnet Electronics 
2111 W. Walnut Hill Lane 
Irving 75062 
Tel: (214) 659-4100 
TWX: 910-860-5929 

tHamilton/Avnet Electronics 
4850 Wright Road #190 
Houston 77477 
Tel: (713) 780-1771 
TWX: 910-881-5523 

tPioneer Electronics 
9901 Burnet Road 
Austin 78758 
Tel: (512) 835-4000 
TWX: 910-874-1323 

Pioneer Electronics 
13710 Omega Road 
Dallas 75234 
Tel: (214) 386-7300 
TWX: 910-850-5563 

Pioneer Electronics 
5853 Point West Drive 
Houston 77036 
Tel: (713) 988-5555 
TWX: 910-881-1606 

UTAH 

tHamilton/Avnet Electronics 
1585 West 2100 South 
Salt Lake City 84119 
Tel: (801) 972-2800 
TWX: 910-925-4018 

Wyle Distribution Group 
1959 South 4130 West, Unit B 
Salt Lake City 84104 
Tel: (801) 974-9953 

WASHINGTON 

tAlmac Electronics Corporation 
14360 S.E. Eastgate Way 
Bellevue 98007 
Tel: (206) 643-9992 
TWX: 910-444-2067 

Arrow Electronics, Inc. 

14320 N.E. 21st Street 
Bellevue 98007 
Tel: (206) 643-4800 
TWX: 910-444-2017 

Hamilton/Avnet Electronics 
14212 N.E. 21st Street 
Bellevue 98005 
Tel: (206) 453-5874 
TWX: 910-443-2469 

WISCONSIN 

tArrow Electronics, Inc. 

430 W. Rausson Avenue 
Oakcreek 53154 
Tel: (414) 764-6600 
TWX: 910-262-1193 


WISCONSIN (Cont’d) 

Hamilton/Avnet Electronics 
2975 Moorland Road 
New Berlin 53151 
Tel: (414) 784-4510 
TWX: 910-262-1182 


CANADA 

ALBERTA 

Hamilton/Avnet Electronics 
2816 21st Street N.E. 

Calgary T2E 6Z2 
Tel: (403) 230-3586 
TWX: 03-827-642 

Hamilton/Avnet Electronics 
6845 Rexwood Road Unit 6 
Mississauga, Ontario L4V1R2 
Tel: (416) 677-0484 

Zentronics 
Bay No. 1 

3360 14th Avenue N.E. 
Calgary T2A 6J4 
Tel: (403) 272-1021 

BRITISH COLUMBIA 

Hamilton/Avnet Electronics 
105-2550 Boundry Road 
Burmalay V5M 3Z3 
Tel: (604) 272-4242 

Zentronics 

108-11400 Bridgeport Road 
Richmond V6X 1T2 
Tel: (604) 273-5575 
TWX: 04-5077-89 

MANITOBA 

Zentronics 
590 Berry Street 
Winnipeg R3H OS1 
Tel: (204) 775-8661 

ONTARIO 

Arrow Electronics Inc. 

24 Marlin Ross Avenue 
Downsview M3J 2K9 
Tel: (416) 661-0220 
TELEX: 06-218213 

Arrow Electronics Inc. 

148 Colonnade Road 
Nepean K2E 7J5 
Tel: (613) 226-6903 

tHamilton/Avnet Electronics 
6845 Rexwood Road 
Units G & H 
Mississauga L4V 1R2 
Tel: (416) 677-7432 
TWX: 610-492-8867 

fHamilton/Avnet Electronics 
210 Colonnade Road South 
Nepean K2E 7L5 
Tel: (613) 226-1700 
TWX: 05-349-71 

fZentronics 
8 Tilbury Court 
Brampton L6T 3T4 
Tel: (416) 451-9600 
TWX: 06-976-78 

Zentronics 

564/10 Weber Street North 
Waterloo N2L 5C6 
Tel: (519) 884-5700 

Zentronics 

155 Colonnade Road 

Unit 17 

Nepean K2E 7K1 
Tel: (613) 225-8840 
TWX: 06-976-78 

QUEBEC 

Arrow Electronics Iric. 

4050 Jean Talon Quest 
Montreal H4P 1W1 
Tel: (514)735-5511 
TELEX: 05-25596 

Arrow Electronics Inc. 

909 Charest Blvd. 

Quebec 61N 269 
Tel: (418) 687-4231 
TLX: 05-13388 

Hamilton/Avnet Electronics 
2795 Rue Halpern 
St. Laurent H4S 1P8 
Tel: (514) 335-1000 
TWX: 610-421-3731 

Zentronics 
505 Locke Street 
St. Laurent H4T 1X7 
Tel: (514) 735-5361 
TWX: 05-827-535 
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